From 8ba76bcb36e9a39aa0f0cc985e9f4c77a3312648 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 19 Oct 2026 04:33:03 +0000 Subject: [PATCH 1/5] feat(courses): every course free, TRI CLAW in the course footer, the whole course on one page (#1703) Owner, 2026-10-19: "make every course free! our task is to grow the language"; "advertise TRI CLAW in the course footer"; "make the page with the course's topic fit on one page ... and make it a widget of widgets". A. Every course free - specs/ladder/course-access.t27: gHashTag/t27 VERSION 3 byte for byte (t27#10799, merge 242ce553); courseAccess.logic.ts rebuilt from it with 999 scripts/t27-logic.mjs (spec-sha256 edd87ade), courseAccess.gen.ts with t27c gen-ts. - courseLadder.ts: a stored course's step is the spec's step_of for its rung, never the step stored with it, so a course opened on a paid rung under VERSION 2 does not close when the club ends (the spec's own instruction to hosts). Test with a mutant that reads the stored step. - The lock, the gate, the club teaser and the rouble/TON pay forms are gone from Course.tsx, with their words, CSS and the checkout client. B. TRI CLAW, three paths, in the footer of every course page - Words and addresses in specs/ladder/course-ladder.t27 (+ RU bundle): own key -> t.me/?start=app_keys, the club -> ?start=app_club, the GitHub App -> its post while CLAW_APP_PUBLIC is false. The bot is the rules' BOT; no price in the words. C/D. The whole course on one page, the course deck, the layout numbers - specs/view/course-view.t27 (+ generator, RU bundle, tests): reading width per language from a measured character width, breakpoints, the frame budget (3 live, mount 600 px, unmount 2000 px), finger, focus, contrast. Course.css may name only its breakpoints. - scripts/course-onepage.mjs: all/ per course and language, lazy frames through public/widgets/frame-pool.js, contents column or sheet with progress dots, #lesson-, share, print CSS. - specs/widgets/course-deck.t27 + public/widgets/course-deck: one widget for every course (?course=), nine module tabs, three lesson frames each; gallery entry before the wars pin; opened as "also" by t27-basics' last lesson so the courses still cover the gallery. - Lesson: text and widget side by side from 1150 px, stacked below with the widget right after the task; prev/next under the thumb; 44 px targets; visible focus; reduced motion. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01ScHVrGSr6zZUdwkdC8DR9k --- .github/workflows/website-checks.yml | 6 +- apps/website/i18n/course-ladder.ru.json | 72 +--- apps/website/i18n/course-view.ru.json | 15 + apps/website/i18n/widgets.ru.json | 13 + apps/website/package.json | 6 +- .../public/widgets/course-deck/card.png | Bin 0 -> 52144 bytes .../public/widgets/course-deck/tool.css | 31 ++ .../public/widgets/course-deck/tool.js | 130 ++++++ apps/website/public/widgets/frame-pool.js | 124 ++++++ .../scripts/course-ladder-from-spec.mjs | 42 +- .../scripts/course-ladder-from-spec.test.mjs | 81 +++- apps/website/scripts/course-onepage.mjs | 361 ++++++++++++++++ apps/website/scripts/course-pages.mjs | 63 ++- apps/website/scripts/course-pages.test.mjs | 104 ++++- .../website/scripts/course-view-from-spec.mjs | 209 +++++++++ .../scripts/course-view-from-spec.test.mjs | 61 +++ apps/website/specs/course/t27-basics.t27 | 2 +- apps/website/specs/ladder/course-access.t27 | 79 +++- apps/website/specs/ladder/course-ladder.t27 | 191 ++++----- apps/website/specs/view/course-view.t27 | 150 +++++++ apps/website/specs/widgets/course-deck.t27 | 68 +++ apps/website/specs/widgets/gallery.t27 | 48 ++- apps/website/src/components/CourseShelf.tsx | 26 +- apps/website/src/components/Footer.tsx | 49 ++- apps/website/src/lib/course.generated.ts | 12 +- apps/website/src/lib/courseAccess.gen.ts | 7 +- apps/website/src/lib/courseAccess.logic.ts | 4 +- .../website/src/lib/courseLadder.generated.ts | 146 ++----- apps/website/src/lib/courseLadder.ts | 159 +------ apps/website/src/lib/courseView.generated.ts | 69 +++ .../website/src/lib/queenWidgets.generated.ts | 21 +- apps/website/src/lib/useLadderView.ts | 8 +- apps/website/src/pages/Blog.tsx | 2 +- apps/website/src/pages/Course.css | 231 +++++----- apps/website/src/pages/Course.tsx | 403 ++++-------------- apps/website/src/pages/Courses.tsx | 33 +- apps/website/src/styles/claw.css | 16 + .../src/styles/courseView.generated.css | 23 + 38 files changed, 2118 insertions(+), 947 deletions(-) create mode 100644 apps/website/i18n/course-view.ru.json create mode 100644 apps/website/public/widgets/course-deck/card.png create mode 100644 apps/website/public/widgets/course-deck/tool.css create mode 100644 apps/website/public/widgets/course-deck/tool.js create mode 100644 apps/website/public/widgets/frame-pool.js create mode 100644 apps/website/scripts/course-onepage.mjs create mode 100644 apps/website/scripts/course-view-from-spec.mjs create mode 100644 apps/website/scripts/course-view-from-spec.test.mjs create mode 100644 apps/website/specs/view/course-view.t27 create mode 100644 apps/website/specs/widgets/course-deck.t27 create mode 100644 apps/website/src/lib/courseView.generated.ts create mode 100644 apps/website/src/styles/claw.css create mode 100644 apps/website/src/styles/courseView.generated.css diff --git a/.github/workflows/website-checks.yml b/.github/workflows/website-checks.yml index 0c08b7b1fc..b332c8d120 100644 --- a/.github/workflows/website-checks.yml +++ b/.github/workflows/website-checks.yml @@ -475,9 +475,11 @@ jobs: # that is missing or changes a number. A crawler drops the '#', so every # lesson also has a static page with its own preview card at /learn// # and /ru/learn//, and every course a landing at its share path; the - # check refuses a page, card or learn/sitemap.xml that lags the specs. + # check refuses a page, card or learn/sitemap.xml that lags the specs. The + # layout numbers (reading width, breakpoints, the widget frame budget of the + # one-page view and the course deck) are specs/view/course-view.t27. - name: Course - run: npm run check:course && npm run test:course && npm run check:course-pages && npm run check:course-ladder && npm run test:course-ladder + run: npm run check:course && npm run test:course && npm run check:course-pages && npm run check:course-ladder && npm run test:course-ladder && npm run check:course-view && npm run test:course-view # The IGLA board on WARS: specs/queen/igla_board.t27 is generated in # gHashTag/igla-coder-gpu from committed artifacts. The gate recompiles it, diff --git a/apps/website/i18n/course-ladder.ru.json b/apps/website/i18n/course-ladder.ru.json index 11f737a852..cdbb4761fa 100644 --- a/apps/website/i18n/course-ladder.ru.json +++ b/apps/website/i18n/course-ladder.ru.json @@ -1,63 +1,31 @@ { - "SAY_LADDER": "Лестница: первые три курса бесплатные и без регистрации, четвёртый и все следующие открываются с клубом. Какие три — выбираете вы.", - "SAY_RUNG": "Ступень {0} вашей лестницы", - "SAY_FREE_TITLE": "Этот курс для вас бесплатный", - "SAY_FREE_LINE": "Откройте одним нажатием. Ничего не спрашиваем, из браузера ничего не уходит.", - "SAY_OPEN": "Открыть курс", - "SAY_BOT_TITLE": "Этот курс открывается в нашем Telegram-боте", - "SAY_BOT_LINE": "Нажмите кнопку: бот откроется со ссылкой на этот курс и вернёт вам ключ, и курс откроется здесь.", - "SAY_BOT_PRESS": "Открыть в Telegram", - "SAY_BOT_SHARES": "С этого шага автор курса видит, какие уроки вы прошли, чтобы помогать. До него из браузера ничего не уходит.", - "SAY_PAID_TITLE": "Этот курс открывается с клубом", - "SAY_PAID_LINE": "Клуб оплачивается звёздами Telegram в боте, там же цена. Уже в клубе? Та же кнопка выдаст ключ.", - "SAY_PAID_PRESS": "Вступить в клуб в Telegram", - "SAY_PAID_LATER": "Оплата здесь картой в долларах пока не сделана.", - "SAY_CLUB_TITLE": "Клуб открывает остальную лестницу", - "SAY_CLUB_LINE": "Четвёртый и все следующие курсы открываются с клубом: наша единственная подписка, оплачивается звёздами Telegram в боте, там же цена. Часть каждого платежа возвращается на ваш баланс в боте — на генерации.", - "SAY_CHECKING": "Проверяем ключ...", - "SAY_KEY_BAD": "Этот ключ не открыл курс ({0}). Нажмите кнопку ещё раз — бот выдаст новый.", - "SAY_SHARED": "Ваши пройденные уроки видит автор курса.", + "SAY_LADDER": "Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.", "SAY_COURSES": "Все курсы", "SAY_CATALOG_TITLE": "Курсы", - "SAY_CATALOG_LEAD": "Каждый курс — 27 коротких уроков в браузере, в каждом живой виджет или спека, которую можно запустить. Любые три — бесплатно, без регистрации и почты; остальные открывает клуб.", - "SAY_FREE_LEFT": "Осталось бесплатных курсов: {0} из 3", - "SAY_FREE_NONE": "Три бесплатных курса выбраны. Все остальные открываются с клубом.", - "SAY_IN_CLUB": "Вы в клубе: открыты все курсы.", + "SAY_CATALOG_LEAD": "Каждый курс — 27 коротких уроков в браузере, в каждом живой виджет или спека, которую можно запустить. Все курсы бесплатные, без регистрации и почты.", "SAY_CONTINUE": "Продолжить с того места, где остановились", "SAY_BADGE_OPEN": "Ваш", "SAY_BADGE_FREE": "Бесплатно", - "SAY_BADGE_CLUB": "Клуб", "SAY_LESSONS": "{0} уроков", "SAY_DONE_OF": "Пройдено {0} из {1}", - "SAY_FREE_SLOT": "Он станет вашим бесплатным курсом {0} из 3.", - "SAY_LAST_FREE": "Это ваш последний бесплатный курс: дальше курсы открываются с клубом.", - "SAY_NOT_NOW": "Не сейчас: к списку курсов", - "SAY_PAY_LINE": "Клуб открывает все курсы на {0} дней. Один платёж в рублях, без автопродления, без Telegram.", - "SAY_PAY_EMAIL": "Email для чека", - "SAY_PAY_PRESS": "Оплатить {0} руб.", - "SAY_PAY_SAFE": "Страница оплаты — Robokassa. После оплаты вы вернётесь сюда, и курс откроется сам.", - "SAY_PAY_BAD_EMAIL": "Этот email выглядит неверно.", - "SAY_PAY_ERROR": "Оплата не началась ({0}). Попробуйте через минуту.", - "SAY_PAY_WAITING": "Ждём подтверждения оплаты...", - "SAY_PAY_SLOW": "Оплата ещё не подтверждена. Если вы оплатили, страница продолжает проверять; можно обновить её позже.", - "SAY_PAY_DONE": "Оплата получена. Добро пожаловать в клуб.", - "SAY_PAY_OR_BOT": "Или оплатить звёздами Telegram в нашем боте", - "SAY_TON_LINE": "Или оплатите в TON из любого кошелька: без карты и без Telegram. Сумма — цена клуба по текущему курсу TON.", - "SAY_TON_EMAIL": "Email, чтобы клуб был вашим на любом устройстве", - "SAY_TON_PRESS": "Оплатить {0} TON", - "SAY_TON_SEND": "Отправьте ровно {0} TON на этот адрес с этим комментарием. По комментарию мы находим ваш платёж.", - "SAY_TON_ADDRESS": "Адрес", - "SAY_TON_AMOUNT": "Сумма", - "SAY_TON_COMMENT": "Комментарий", - "SAY_TON_COPY": "Скопировать", - "SAY_TON_COPIED": "Скопировано", - "SAY_TON_OPEN": "Открыть в кошельке", - "SAY_TON_UNTIL": "Сумма действует до {0}. Страница сама откроет курс, когда платёж придёт.", - "SAY_TON_EXPIRED": "Заказ TON истёк, а платёж не пришёл. Создайте новый; если вы уже отправили TON, напишите нам в боте и укажите комментарий.", + "SAY_SHARED": "Ваши пройденные уроки видит автор курса.", "SAY_MORE_TITLE": "Другие курсы", - "SAY_PROMO_TITLE": "Три курса бесплатно, без регистрации", - "SAY_PROMO_LINE": "Каждый урок идёт прямо в браузере, с живым виджетом или спецификацией, которую можно запустить. Любые три курса бесплатно, без регистрации.", + "SAY_PROMO_TITLE": "Все курсы бесплатно, без регистрации", + "SAY_PROMO_LINE": "Каждый урок идёт прямо в браузере, с живым виджетом или спекой, которую можно запустить. Все курсы бесплатные, без регистрации.", "SAY_PROMO_PRESS": "Смотреть курсы", - "SAY_SIGN_IN": "Уже в клубе? Войти через Telegram", - "SAY_SIGNED_IN": "Вы вошли: ключ клуба сохранён в этом браузере." + "SAY_CLAW_KICKER": "TRI CLAW", + "SAY_CLAW_TITLE": "Агент, который стоит за t27, — в Telegram и на GitHub", + "SAY_CLAW_LINE": "TRI CLAW — агент проекта: пишет и проверяет спеки .t27 вместе с вами. Три способа им пользоваться.", + "SAY_CLAW_FREE_TITLE": "Бесплатно, со своим ключом", + "SAY_CLAW_FREE_LINE": "Добавьте свой API-ключ (сегодня NVIDIA или z.ai), и агент работает на нём. Ещё ключи можно добавить в любой момент.", + "SAY_CLAW_FREE_PRESS": "Добавить ключ в Telegram", + "SAY_CLAW_PAID_TITLE": "Сделаем за вас", + "SAY_CLAW_PAID_LINE": "Никаких ключей: вступите в клуб в нашем Telegram-боте, и агент работает на наших. Бот показывает цену до оплаты.", + "SAY_CLAW_PAID_PRESS": "Вступить в клуб в Telegram", + "SAY_CLAW_APP_TITLE": "В вашем репозитории", + "SAY_CLAW_APP_LINE": "GitHub-приложение TRI CLAW проверяет спеки .t27, которые меняет пулл-реквест.", + "SAY_CLAW_APP_PRESS": "Установить TRI CLAW в свой репозиторий", + "SAY_CLAW_POST_TITLE": "На GitHub", + "SAY_CLAW_POST_LINE": "TRI CLAW — ещё и GitHub-приложение, которое проверяет спеки .t27 в пулл-реквестах. Для других репозиториев оно пока не открыто.", + "SAY_CLAW_POST_PRESS": "Прочитать о TRI CLAW" } diff --git a/apps/website/i18n/course-view.ru.json b/apps/website/i18n/course-view.ru.json new file mode 100644 index 0000000000..04041c7e9c --- /dev/null +++ b/apps/website/i18n/course-view.ru.json @@ -0,0 +1,15 @@ +{ + "SAY_ONE_PAGE": "Весь курс на одной странице", + "SAY_ONE_PAGE_LINE": "Все 27 уроков и их виджеты на одной странице: одна ссылка, чтобы поделиться, одна страница, чтобы читать.", + "SAY_ONE_PAGE_TITLE": "{0}: весь курс на одной странице", + "SAY_CONTENTS": "Содержание", + "SAY_SHARE_PAGE": "Поделиться курсом", + "SAY_SHARE_LESSON": "Поделиться уроком", + "SAY_COPY": "Скопировать ссылку", + "SAY_COPIED": "Ссылка скопирована", + "SAY_LESSON_LINK": "Ссылка на этот урок на этой странице", + "SAY_LOAD": "Загрузить виджет", + "SAY_WAITING": "Виджет загрузится, когда вы до него докрутите.", + "SAY_TOP": "Наверх", + "SAY_JUMP": "Перейти к уроку" +} diff --git a/apps/website/i18n/widgets.ru.json b/apps/website/i18n/widgets.ru.json index b9aa61b668..2cb70c300a 100644 --- a/apps/website/i18n/widgets.ru.json +++ b/apps/website/i18n/widgets.ru.json @@ -629,6 +629,19 @@ "error: constant 'N' declares u8 but its value has 3 digits, which no u8 can hold" ], "SAY_NOTE": "Строка ошибки — ответ t27_compiler.wasm на pub const N : u8 = 300;" + }, + "course-deck": { + "SAY_MODULES": "Модули", + "SAY_MODULE": "Модуль {0}", + "SAY_LESSON": "Урок {0} из {1}", + "SAY_GOAL": "Вы узнаете", + "SAY_OPEN_LESSON": "Открыть урок", + "SAY_ONE_PAGE": "Весь курс на одной странице", + "SAY_LOAD": "Загрузить виджет", + "SAY_PREV": "Предыдущий урок", + "SAY_NEXT": "Следующий урок", + "SAY_FREE": "Бесплатный курс", + "SAY_NOT_FOUND": "Такого курса нет в каталоге." } } } diff --git a/apps/website/package.json b/apps/website/package.json index a8762414a3..bb89d7fe18 100644 --- a/apps/website/package.json +++ b/apps/website/package.json @@ -6,7 +6,7 @@ "scripts": { "check:queen-evidence": "node scripts/queen-evidence-from-spec.mjs --check", "predev": "node scripts/queen-evidence-from-spec.mjs --check", - "prebuild:ci": "npm run core -- index && node scripts/skills-core.mjs index && node scripts/agents-from-specs.mjs && node scripts/docs-from-specs.mjs && node scripts/viewport-from-spec.mjs && node scripts/onboarding-from-spec.mjs && node scripts/play-from-spec.mjs && node scripts/queen-wars-from-spec.mjs && node scripts/widget-pages-from-spec.mjs && node scripts/widget-logic.mjs --check && node scripts/widgets-from-spec.mjs && node scripts/course-from-spec.mjs && node scripts/course-ladder-from-spec.mjs && node scripts/igla-board-from-spec.mjs && node scripts/queen-evidence-from-spec.mjs --check", + "prebuild:ci": "npm run core -- index && node scripts/skills-core.mjs index && node scripts/agents-from-specs.mjs && node scripts/docs-from-specs.mjs && node scripts/viewport-from-spec.mjs && node scripts/onboarding-from-spec.mjs && node scripts/play-from-spec.mjs && node scripts/queen-wars-from-spec.mjs && node scripts/widget-pages-from-spec.mjs && node scripts/widget-logic.mjs --check && node scripts/widgets-from-spec.mjs && node scripts/course-from-spec.mjs && node scripts/course-ladder-from-spec.mjs && node scripts/course-view-from-spec.mjs && node scripts/igla-board-from-spec.mjs && node scripts/queen-evidence-from-spec.mjs --check", "atlas": "node --experimental-strip-types scripts/universe-atlas.mjs", "discover": "node scripts/discover-t27-worlds.mjs", "check:discovery": "node --experimental-strip-types qa/t27-world-discovery.mjs", @@ -21,7 +21,7 @@ "check:traffic-arrival": "node --experimental-strip-types qa/traffic-arrival-contract.mjs", "core": "node scripts/spec-core.mjs", "check:shared-core": "node --experimental-strip-types qa/shared-spec-core.mjs", - "prebuild": "npm run core -- index && node scripts/skills-core.mjs index && node scripts/agents-from-specs.mjs && node scripts/docs-from-specs.mjs && node scripts/viewport-from-spec.mjs && node scripts/onboarding-from-spec.mjs && node scripts/play-from-spec.mjs && node scripts/queen-wars-from-spec.mjs && node scripts/widget-pages-from-spec.mjs && node scripts/widget-logic.mjs --check && node scripts/widgets-from-spec.mjs && node scripts/course-from-spec.mjs && node scripts/course-ladder-from-spec.mjs && node scripts/igla-board-from-spec.mjs", + "prebuild": "npm run core -- index && node scripts/skills-core.mjs index && node scripts/agents-from-specs.mjs && node scripts/docs-from-specs.mjs && node scripts/viewport-from-spec.mjs && node scripts/onboarding-from-spec.mjs && node scripts/play-from-spec.mjs && node scripts/queen-wars-from-spec.mjs && node scripts/widget-pages-from-spec.mjs && node scripts/widget-logic.mjs --check && node scripts/widgets-from-spec.mjs && node scripts/course-from-spec.mjs && node scripts/course-ladder-from-spec.mjs && node scripts/course-view-from-spec.mjs && node scripts/igla-board-from-spec.mjs", "dev": "vite", "build": "vite build", "build:ci": "vite build", @@ -128,6 +128,8 @@ "test:widget-logic": "node --test scripts/widget-logic.test.mjs", "check:course-ladder": "node scripts/course-ladder-from-spec.mjs --check", "test:course-ladder": "node --test scripts/course-ladder-from-spec.test.mjs", + "check:course-view": "node scripts/course-view-from-spec.mjs --check", + "test:course-view": "node --test scripts/course-view-from-spec.test.mjs", "test:course": "node --test scripts/course-from-spec.test.mjs scripts/lesson-specs.test.mjs scripts/t27c-mutation-casts.test.mjs", "gen:course-pages": "node scripts/course-pages.mjs", "check:course-pages": "node scripts/course-pages.mjs --check && node --test scripts/course-pages.test.mjs", diff --git a/apps/website/public/widgets/course-deck/card.png b/apps/website/public/widgets/course-deck/card.png new file mode 100644 index 0000000000000000000000000000000000000000..cd07957c1e4b38c06e4024180aa2512d7f41dca6 GIT binary patch literal 52144 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.json beside this file, written by scripts/course-pages.mjs from the course specs. +// ?course= picks the course (the catalog's first when absent), &module= the module tab, +// &lang=ru the Russian words. Each lesson card nests that lesson's own widget page; ../frame-pool.js +// mounts a frame only as its card nears the row's view and keeps K_LIVE_FRAMES_MAX of them live. +import { framePool } from '../frame-pool.js' + +const W = window.T27_WIDGET +const q = new URLSearchParams(location.search) +const lang = q.get('lang') === 'ru' ? 'ru' : 'en' +const fmt = (s, ...a) => a.reduce((o, x, i) => o.split(`{${i}}`).join(String(x)), s) +const el = (tag, cls, text) => { + const e = document.createElement(tag) + if (cls) e.className = cls + if (text != null) e.textContent = text + return e +} +const css = document.createElement('link') +css.rel = 'stylesheet' +css.href = new URL('./tool.css', import.meta.url).href +document.head.append(css) + +const root = document.getElementById('widget') +root.style.setProperty('--cd-touch', `${W.K_TOUCH_TARGET_PX}px`) +const ROOT = new URL('../../', import.meta.url).href + +async function load(path) { + const r = await fetch(new URL(path, import.meta.url)) + if (!r.ok) throw new Error(String(r.status)) + return r.json() +} + +const catalog = await load('./courses/index.json') +const pick = catalog.find((c) => c.id === q.get('course')) ?? catalog[0] +let course = null +try { + course = await load(`./courses/${pick.id}.json`) +} catch { + root.append(el('p', 'cd-empty', W.SAY_NOT_FOUND)) +} + +let pool = null +function show(n) { + const mod = course.modules.find((m) => m.n === n) ?? course.modules[0] + for (const t of tabs.querySelectorAll('[role=tab]')) { + const on = Number(t.dataset.n) === mod.n + t.setAttribute('aria-selected', String(on)) + t.tabIndex = on ? 0 : -1 + } + if (pool) pool.stop() + row.replaceChildren() + const total = course.modules.reduce((k, m) => k + m.lessons.length, 0) + for (const l of mod.lessons) { + const card = el('article', 'cd-card') + card.append(el('p', 'cd-n', fmt(W.SAY_LESSON, l.n, total)), el('h3', 'cd-title', l.title[lang])) + const goal = el('p', 'cd-goal') + goal.append(el('span', 'cd-label', W.SAY_GOAL), document.createTextNode(l.goal[lang])) + card.append(goal) + const slot = el('div', 'cd-slot') + slot.style.height = `${l.height}px` + slot.dataset.src = `${ROOT}${l.frame}${lang === 'ru' && l.frame.startsWith('widgets/') ? `${l.frame.includes('?') ? '&' : '?'}lang=ru` : ''}` + slot.dataset.title = l.widget + const ph = el('div', 'cd-ph') + const press = el('button', 'cd-btn', W.SAY_LOAD) + press.type = 'button' + press.dataset.load = '' + ph.append(el('span', 'cd-ph-title', l.widget), press) + slot.append(ph) + card.append(slot) + const open = el('a', 'cd-link', `${W.SAY_OPEN_LESSON} ↗`) + open.href = `${ROOT}#/${course.route}/${l.id}` + open.target = '_top' + card.append(open) + row.append(card) + } + row.scrollLeft = 0 + pool = framePool({ slots: row.querySelectorAll('.cd-slot'), live: W.K_LIVE_FRAMES_MAX, mount: W.K_MOUNT_MARGIN_PX, unmount: W.K_UNMOUNT_MARGIN_PX, root: row }) + window.__t27Pool = pool +} + +let tabs = null +let row = null +if (course) { + const deck = el('div', 'cd') + const head = el('header', 'cd-head') + head.append(el('p', 'cd-kicker', W.SAY_FREE), el('h2', 'cd-course', course.title[lang])) + const one = el('a', 'cd-btn cd-onepage', `${W.SAY_ONE_PAGE} ↗`) + one.href = new URL(course.onePage[lang].replace(/^\//, ''), ROOT).href + one.target = '_top' + head.append(one) + tabs = el('div', 'cd-tabs') + tabs.setAttribute('role', 'tablist') + tabs.setAttribute('aria-label', W.SAY_MODULES) + for (const m of course.modules) { + const t = el('button', 'cd-tab') + t.type = 'button' + t.setAttribute('role', 'tab') + t.dataset.n = String(m.n) + t.title = m.title[lang] + t.append(el('b', '', String(m.n).padStart(2, '0')), el('span', '', m.title[lang])) + t.addEventListener('click', () => show(m.n)) + tabs.append(t) + } + tabs.addEventListener('keydown', (e) => { + if (e.key !== 'ArrowRight' && e.key !== 'ArrowLeft') return + const all = [...tabs.querySelectorAll('[role=tab]')] + const at = all.findIndex((t) => t.getAttribute('aria-selected') === 'true') + const next = all[(at + (e.key === 'ArrowRight' ? 1 : all.length - 1)) % all.length] + next.focus() + show(Number(next.dataset.n)) + }) + row = el('div', 'cd-row') + row.setAttribute('role', 'tabpanel') + row.tabIndex = 0 + const nav = el('nav', 'cd-nav') + const step = (dir) => row.scrollBy({ left: dir * row.clientWidth, behavior: matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth' }) + const prev = el('button', 'cd-btn', `← ${W.SAY_PREV}`) + const next = el('button', 'cd-btn', `${W.SAY_NEXT} →`) + prev.type = next.type = 'button' + prev.addEventListener('click', () => step(-1)) + next.addEventListener('click', () => step(1)) + nav.append(prev, next) + deck.append(head, tabs, row, nav) + root.append(deck) + const n = Number(q.get('module')) + show(Number.isInteger(n) && n >= 1 && n <= W.K_MODULES ? n : 1) +} diff --git a/apps/website/public/widgets/frame-pool.js b/apps/website/public/widgets/frame-pool.js new file mode 100644 index 0000000000..6c3cffd9c9 --- /dev/null +++ b/apps/website/public/widgets/frame-pool.js @@ -0,0 +1,124 @@ +// frame-pool.js -- many widget frames on one page, few of them live. +// +// Used by the whole-course-on-one-page view (learn//all/, scripts/course-pages.mjs) and by +// the course-deck widget (widgets/course-deck/tool.js). Both pass the numbers of +// specs/view/course-view.t27 in; this file holds none of its own. +// +// A slot is an element with data-src (the widget page to frame) and data-title, whose height is +// already set to the frame's height, so a frame coming or going moves nothing below it. A slot +// mounts its iframe when it comes within `mount` px of the viewport (or of `root`, for a deck +// that scrolls sideways). At most `live` frames are mounted at once: a new one takes the place +// of the mounted frame farthest from the viewport. A frame farther than `unmount` px away is +// taken down, and its slot shows its placeholder again. A press on the slot's [data-load] +// button mounts it at once. +// +// The page can read how many frames are live: document.documentElement.dataset.liveFrames, and +// the pool's own live() and peak(). + +export function framePool({ slots, live, mount, unmount, root = null, onChange = () => {} }) { + if (!(live >= 1) || !(unmount > mount)) throw new RangeError('frame-pool: live >= 1 and unmount > mount') + const mounted = new Set() + let peak = 0 + const all = [...slots] + + const report = () => { + peak = Math.max(peak, mounted.size) + document.documentElement.dataset.liveFrames = String(mounted.size) + onChange(mounted.size) + } + + // How far a slot is from what the reader sees: 0 inside, else the gap in px. + const distance = (el) => { + const r = el.getBoundingClientRect() + const view = root ? root.getBoundingClientRect() : { top: 0, left: 0, bottom: innerHeight, right: innerWidth } + const dy = r.bottom < view.top ? view.top - r.bottom : r.top > view.bottom ? r.top - view.bottom : 0 + const dx = r.right < view.left ? view.left - r.right : r.left > view.right ? r.left - view.right : 0 + return Math.max(dx, dy) + } + + function take(slot) { + const frame = slot.querySelector('iframe') + if (frame) frame.remove() + slot.classList.remove('is-live') + slot.dataset.live = '0' + mounted.delete(slot) + } + + function put(slot) { + if (mounted.has(slot)) return + const f = document.createElement('iframe') + f.src = slot.dataset.src + f.title = slot.dataset.title || '' + f.setAttribute('allow', 'clipboard-write') + f.setAttribute('referrerpolicy', 'no-referrer') + slot.appendChild(f) + slot.classList.add('is-live') + slot.dataset.live = '1' + mounted.add(slot) + } + + // The slots within `mount` px of the viewport, nearest first, are the ones that should be + // live; a mounted frame outside that set gives way only when one of them needs its place. + const wanted = new Set() + function rebalance(first) { + const order = [...wanted].sort((a, b) => distance(a) - distance(b)) + if (first && !order.includes(first)) order.unshift(first) + const desired = order.slice(0, live) + for (const slot of desired) { + if (mounted.has(slot)) continue + if (mounted.size >= live) { + const spare = [...mounted].filter((m) => !desired.includes(m)).sort((a, b) => distance(b) - distance(a))[0] + if (!spare) break + take(spare) + } + put(slot) + } + report() + } + + const near = new IntersectionObserver( + (entries) => { + for (const e of entries) e.isIntersecting ? wanted.add(e.target) : wanted.delete(e.target) + rebalance() + }, + { root, rootMargin: `${mount}px` }, + ) + const far = new IntersectionObserver( + (entries) => { + for (const e of entries) if (!e.isIntersecting && mounted.has(e.target)) take(e.target) + rebalance() + }, + { root, rootMargin: `${unmount}px` }, + ) + // A slot that stayed in the near zone while it gave way comes back once it is among the nearest. + let pending = 0 + const settle = () => { + clearTimeout(pending) + pending = setTimeout(() => rebalance(), 120) + } + ;(root ?? window).addEventListener('scroll', settle, { passive: true }) + + for (const slot of all) { + slot.dataset.live = '0' + near.observe(slot) + far.observe(slot) + const press = slot.querySelector('[data-load]') + if (press) press.addEventListener('click', () => rebalance(slot)) + } + report() + + return { + live: () => mounted.size, + peak: () => peak, + /** Take every frame down and stop watching: a deck switching modules gives its slots back. */ + stop() { + near.disconnect() + far.disconnect() + ;(root ?? window).removeEventListener('scroll', settle) + clearTimeout(pending) + wanted.clear() + for (const s of [...mounted]) take(s) + report() + }, + } +} diff --git a/apps/website/scripts/course-ladder-from-spec.mjs b/apps/website/scripts/course-ladder-from-spec.mjs index 6a2bc43358..e83e21c972 100644 --- a/apps/website/scripts/course-ladder-from-spec.mjs +++ b/apps/website/scripts/course-ladder-from-spec.mjs @@ -12,8 +12,12 @@ // The WORDS are specs/ladder/course-ladder.t27 (English) and i18n/course-ladder.ru.json // (Russian: every SAY_ key, no other key, the same {placeholders} and digits). // +// The TRI CLAW links are joined here from the two specs, so neither restates the other: the bot +// is BOT of the rules, the routes and the App are the words spec's. CLAW_APP_PUBLIC picks the +// third path: the App's page once it installs for anyone, the TRI CLAW post until then. +// // Writes the file nobody edits by hand: -// src/lib/courseLadder.generated.ts the words, the render address, the browser keys +// src/lib/courseLadder.generated.ts the words, the TRI CLAW links, the render address, the browser keys // // Run: node scripts/course-ladder-from-spec.mjs (write) // node scripts/course-ladder-from-spec.mjs --check (fail if stale) @@ -34,7 +38,10 @@ export const TS_OUT = 'src/lib/courseLadder.generated.ts' const WORDS_REQUIRED = { KIND: 'str', SCHEMA_VERSION: 'u8', GENERATED: 'arr', RULES_SPEC: 'str', RENDER_BASE: 'str', OPEN_KEY: 'str', KEYS_KEY: 'str', + APP_START_PREFIX: 'str', CLAW_KEYS_ROUTE: 'str', CLAW_CLUB_ROUTE: 'str', CLAW_APP_URL: 'str', CLAW_POST_PATH: 'str', CLAW_APP_PUBLIC: 'bool', CLAW_PATHS: 'u8', } +const ORIGIN = 'https://t27.ai/' +const ROUTE_RE = /^[a-z][a-z0-9_-]*$/ const sha256 = (text) => createHash('sha256').update(text, 'utf8').digest('hex') const holes = (s) => [...String(s).matchAll(/\{\d+\}|\d+/g)].map((m) => m[0]).sort().join(',') @@ -45,7 +52,10 @@ export function genValues(genText) { return out } -export function ladderProblems({ rulesText, wordsText, ruText, logicText, genText, analyze }) { +/** The words a page can show: of the third path's two sets, only the one CLAW_APP_PUBLIC picks. */ +const shown = (says, claw) => Object.keys(says).filter((k) => !k.startsWith(claw.githubIsApp ? 'SAY_CLAW_POST_' : 'SAY_CLAW_APP_')) + +export function ladderProblems({ rulesText, wordsText, ruText, logicText, genText, analyze, postExists = (slug) => existsSync(join(SITE, 'src/data/blog/bodies', `${slug}.ts`)) }) { const p = [] // The rules: compile clean, the logic built from exactly these bytes, gen.ts says what they say. const rules = analyze(rulesText) @@ -81,6 +91,27 @@ export function ladderProblems({ rulesText, wordsText, ruText, logicText, genTex if (w.RULES_SPEC !== RULES_SPEC) p.push(`${WORDS_SPEC}: RULES_SPEC must be ${RULES_SPEC}`) if (JSON.stringify(w.GENERATED) !== JSON.stringify([TS_OUT])) p.push(`${WORDS_SPEC}: GENERATED must be ${JSON.stringify([TS_OUT])}`) if (!/^https:\/\/[a-z0-9.-]+$/.test(String(w.RENDER_BASE ?? ''))) p.push(`${WORDS_SPEC}: RENDER_BASE must be a bare https origin`) + // TRI CLAW: three paths, each a real place. The payload fits Telegram's start ceiling (the rules' + // START_MAX_CHARS), the App address is a GitHub App page, the post is a post of this site. + const bot = rc.BOT?.value + const claw = { keys: '', club: '', github: '', githubIsApp: false } + if (typeof bot !== 'string' || !/^[A-Za-z0-9_]{5,32}$/.test(bot)) p.push(`${RULES_SPEC}: BOT is not a Telegram bot handle`) + else { + for (const k of ['CLAW_KEYS_ROUTE', 'CLAW_CLUB_ROUTE']) { + const payload = `${w.APP_START_PREFIX ?? ''}${w[k] ?? ''}` + if (!ROUTE_RE.test(String(w[k] ?? ''))) p.push(`${WORDS_SPEC}: ${k} is not an app route`) + else if (payload.length > (rc.START_MAX_CHARS?.value ?? 0)) p.push(`${WORDS_SPEC}: start=${payload} is over ${rc.START_MAX_CHARS?.value} characters`) + } + claw.keys = `https://t.me/${bot}?start=${w.APP_START_PREFIX}${w.CLAW_KEYS_ROUTE}` + claw.club = `https://t.me/${bot}?start=${w.APP_START_PREFIX}${w.CLAW_CLUB_ROUTE}` + } + if (!/^https:\/\/github\.com\/apps\/[a-z0-9-]+$/.test(String(w.CLAW_APP_URL ?? ''))) p.push(`${WORDS_SPEC}: CLAW_APP_URL must be a GitHub App page`) + const slug = String(w.CLAW_POST_PATH ?? '').match(/^blog\/([a-z0-9-]+)\/$/)?.[1] + if (!slug) p.push(`${WORDS_SPEC}: CLAW_POST_PATH must be blog//`) + else if (!postExists(slug)) p.push(`${WORDS_SPEC}: CLAW_POST_PATH names ${slug}, which is not a post of src/data/blog/bodies`) + claw.githubIsApp = w.CLAW_APP_PUBLIC === true + claw.github = claw.githubIsApp ? w.CLAW_APP_URL : `${ORIGIN}${w.CLAW_POST_PATH}` + if (w.CLAW_PATHS !== 3) p.push(`${WORDS_SPEC}: CLAW_PATHS must be 3 (own key, the club, GitHub)`) const tests = runSpecTests(words, w) if (tests.tests < 1) p.push(`${WORDS_SPEC}: needs at least one test block`) p.push(...tests.failures.map((f) => `${WORDS_SPEC}: ${f}`)) @@ -102,9 +133,10 @@ export function ladderProblems({ rulesText, wordsText, ruText, logicText, genTex openKey: w.OPEN_KEY, keysKey: w.KEYS_KEY, rulesSha: sha256(rulesText), + claw, say: { - en: Object.fromEntries(Object.keys(says).map((k) => [k.slice(4), w[k]])), - ru: Object.fromEntries(Object.keys(says).map((k) => [k.slice(4), ru[k]])), + en: Object.fromEntries(shown(says, claw).map((k) => [k.slice(4), w[k]])), + ru: Object.fromEntries(shown(says, claw).map((k) => [k.slice(4), ru[k]])), }, } return { problems: p, out } @@ -115,7 +147,7 @@ export const renderTs = (o) => `// GENERATED by scripts/course-ladder-from-spec. // Do not edit: change the .t27 source (or the Russian bundle) and regenerate. The rules // themselves run from ${LOGIC_TS}; their numbers are in ${GEN_TS}. -export const LADDER = ${JSON.stringify({ renderBase: o.renderBase, openKey: o.openKey, keysKey: o.keysKey, say: o.say }, null, 2)} as const +export const LADDER = ${JSON.stringify({ renderBase: o.renderBase, openKey: o.openKey, keysKey: o.keysKey, claw: o.claw, say: o.say }, null, 2)} as const export type LadderSay = (typeof LADDER.say)['en'] ` diff --git a/apps/website/scripts/course-ladder-from-spec.test.mjs b/apps/website/scripts/course-ladder-from-spec.test.mjs index 44f7c63cd9..a5fdedbebc 100644 --- a/apps/website/scripts/course-ladder-from-spec.test.mjs +++ b/apps/website/scripts/course-ladder-from-spec.test.mjs @@ -26,7 +26,7 @@ test('the committed ladder builds clean and the generated file is current', () = }) test('a rule changed in the spec without rebuilding the logic stops the build', () => { - fails({ rulesText: replaced(inputs.rulesText, 'if opened >= 3 {', 'if opened >= 4 {') }, 'built from another version') + fails({ rulesText: replaced(inputs.rulesText, 'pub const LADDER_RUNGS : u8 = 1;', 'pub const LADDER_RUNGS : u8 = 2;') }, 'built from another version') }) test('a number edited in gen.ts without the spec stops the build', () => { @@ -35,13 +35,82 @@ test('a number edited in gen.ts without the spec stops the build', () => { test('a Russian word missing, extra, or with another placeholder stops the build', () => { const ru = JSON.parse(inputs.ruText) - const { SAY_OPEN, ...noOpen } = ru - void SAY_OPEN - fails({ ruText: JSON.stringify(noOpen) }, 'SAY_OPEN is missing') + const { SAY_CLAW_FREE_PRESS, ...noPress } = ru + void SAY_CLAW_FREE_PRESS + fails({ ruText: JSON.stringify(noPress) }, 'SAY_CLAW_FREE_PRESS is missing') fails({ ruText: JSON.stringify({ ...ru, SAY_EXTRA: 'x' }) }, 'SAY_EXTRA is not a word') - fails({ ruText: JSON.stringify({ ...ru, SAY_RUNG: 'Ступень вашей лестницы' }) }, 'SAY_RUNG keeps other numbers') + fails({ ruText: JSON.stringify({ ...ru, SAY_LESSONS: 'уроков' }) }, 'SAY_LESSONS keeps other numbers') }) test('Russian in the English spec stops the build', () => { - fails({ wordsText: replaced(inputs.wordsText, '"Open the course"', '"Открыть курс"') }, 'Cyrillic') + fails({ wordsText: replaced(inputs.wordsText, '"See the courses"', '"Смотреть курсы"') }, 'Cyrillic') +}) + +test('every course is free: the words say so and no gate word is left', () => { + const { out } = run() + assert.match(out.say.en.LADDER, /Every course is free/) + for (const gone of ['PAID_TITLE', 'PAY_PRESS', 'TON_PRESS', 'FREE_LEFT', 'BADGE_CLUB', 'SIGN_IN', 'CLUB_LINE']) assert.ok(!(gone in out.say.en), `${gone} is still a word`) + assert.doesNotMatch(inputs.wordsText, /\b(the only|the first|best|fastest)\b/i, 'no superlative') +}) + +test('TRI CLAW: the key screen and the club open inside Telegram, with the rules bot', () => { + const { out } = run() + assert.equal(out.claw.keys, 'https://t.me/t27ai_bot?start=app_keys') + assert.equal(out.claw.club, 'https://t.me/t27ai_bot?start=app_club') + // The handle is the rules' BOT, vendored byte for byte: edited here alone, the build stops. + const moved = run({ rulesText: replaced(inputs.rulesText, 'pub const BOT : str = "t27ai_bot";', 'pub const BOT : str = "other_bot";') }) + assert.ok(moved.problems.some((p) => p.includes('built from another version'))) + fails({ wordsText: replaced(inputs.wordsText, 'pub const CLAW_KEYS_ROUTE : str = "keys";', 'pub const CLAW_KEYS_ROUTE : str = "Keys!";') }, 'CLAW_KEYS_ROUTE is not an app route') +}) + +test('TRI CLAW: the App is linked only once it is called public; until then, the post', () => { + const { out } = run() + assert.equal(out.claw.githubIsApp, false) + assert.equal(out.claw.github, 'https://t27.ai/blog/tri-claw-an-agent-you-can-audit/') + assert.ok('CLAW_POST_PRESS' in out.say.en && !('CLAW_APP_PRESS' in out.say.en)) + // The owner flips one constant; its own spec test says the claim is not made yet, so the build + // stops until that test is changed with it. + fails({ wordsText: replaced(inputs.wordsText, 'pub const CLAW_APP_PUBLIC : bool = false;', 'pub const CLAW_APP_PUBLIC : bool = true;') }, 'the_app_is_not_called_open_until_it_is') + const flipped = replaced(replaced(inputs.wordsText, 'pub const CLAW_APP_PUBLIC : bool = false;', 'pub const CLAW_APP_PUBLIC : bool = true;'), 'assert CLAW_APP_PUBLIC == false;', 'assert CLAW_APP_PUBLIC == true;') + const open = run({ wordsText: flipped }) + assert.deepEqual(open.problems, []) + assert.equal(open.out.claw.github, 'https://github.com/apps/tri-claw') + assert.ok('CLAW_APP_PRESS' in open.out.say.en && !('CLAW_POST_PRESS' in open.out.say.en)) + fails({ postExists: () => false }, 'which is not a post') + fails({ wordsText: replaced(inputs.wordsText, '"https://github.com/apps/tri-claw";', '"https://example.com/tri-claw";') }, 'CLAW_APP_URL') +}) + +// The host: src/lib/courseLadder.ts, bundled as the site bundles it, over a browser store. +const { build } = await import('esbuild') +async function host(stored) { + const mem = new Map(stored ? [['t27-course-open', JSON.stringify(stored)]] : []) + globalThis.window = { localStorage: { getItem: (k) => mem.get(k) ?? null, setItem: (k, v) => mem.set(k, v) } } + const r = await build({ entryPoints: [join(SITE, 'src/lib/courseLadder.ts')], bundle: true, write: false, format: 'esm', platform: 'neutral', logLevel: 'silent' }) + return { mod: await import(`data:text/javascript;base64,${Buffer.from(r.outputFiles[0].text).toString('base64')}`), mem } +} + +test('a course stored on a paid rung under VERSION 2 stays open when the club ends (re-runged by step_of)', async () => { + const { mod } = await host([{ id: 'a', step: 0 }, { id: 'b', step: 0 }, { id: 'c', step: 0 }, { id: 'd', step: 2 }]) + const opened = mod.readOpened(['a', 'b', 'c', 'd', 'e'], []) + const noClub = { bot: false, paid: false } + const d = mod.courseState('d', opened, noClub) + assert.equal(d.known, true) + assert.equal(d.step, mod.STEP.free, 'the stored PAID step is not the step') + assert.equal(d.open, true) + // What the stored step alone would have said: closed. The re-rung is what keeps it. + const logic = await import(`data:text/javascript;base64,${Buffer.from((await build({ entryPoints: [join(SITE, 'src/lib/courseAccess.logic.ts')], bundle: true, write: false, format: 'esm', platform: 'neutral', logLevel: 'silent' })).outputFiles[0].text).toString('base64')}`) + assert.equal(logic.staysOpen(mod.STEP.paid, false), false) +}) + +test('every course opens, for every reader, however many he opened', async () => { + const { mod } = await host(null) + const ids = Array.from({ length: 30 }, (_, i) => `c${i}`) + let opened = mod.readOpened(ids, []) + for (const id of ids) { + const s = mod.courseState(id, opened, { bot: false, paid: false }) + assert.equal(s.open, true, `${id} is not open on rung ${s.rung}`) + opened = mod.openCourse(id, opened, { bot: false, paid: false }) + } + assert.equal(opened.length, ids.length) + assert.ok(opened.every((o) => o.step === mod.STEP.free)) }) diff --git a/apps/website/scripts/course-onepage.mjs b/apps/website/scripts/course-onepage.mjs new file mode 100644 index 0000000000..2ab9b95fc8 --- /dev/null +++ b/apps/website/scripts/course-onepage.mjs @@ -0,0 +1,361 @@ +// course-onepage.mjs -- the whole course on one page, and the data the course-deck widget reads. +// +// Owner, 2026-10-19: "make the page with the course's topic fit on one page, so it spreads in the +// network at once -- all the text fits there; and make this page a widget that holds the other +// widgets". scripts/course-pages.mjs calls this for every course and language and writes: +// +// public//index.html t27.ai/learn/all/, t27.ai/learn//all/, +// and ru/ before each: the course, every module, +// every lesson's words and its widget +// public/widgets/course-deck/courses/.json one course's lessons for the course-deck widget +// +// Every word is a spec's: the course specs (src/lib/course.generated.ts), the one-page view's words +// and every number of the layout (specs/view/course-view.t27 -> src/lib/courseView.generated.ts and +// src/styles/courseView.generated.css), and the TRI CLAW block (specs/ladder/course-ladder.t27 -> +// src/lib/courseLadder.generated.ts). The frames are mounted by public/widgets/frame-pool.js with the +// view spec's budget, so a phone with 27 lessons keeps LIVE_FRAMES_MAX frames, not 27. + +import { readFileSync } from 'node:fs' +import { join } from 'node:path' + +export const esc = (s) => String(s).replace(/&/g, '&').replace(//g, '>').replace(/"/g, '"') +export const fmt = (s, ...a) => a.reduce((out, x, i) => out.split(`{${i}}`).join(String(x)), s) +export const pad = (n) => String(n).padStart(2, '0') +const json = (v) => JSON.stringify(v).replace(/ (s.length <= max ? s : `${s.slice(0, max).replace(/\s+\S*$/, '')}…`) + +/** The object a generated module exports as `export const = {...} as const`. */ +export function loadConst(file, name) { + const s = readFileSync(file, 'utf8') + const head = `export const ${name} = ` + const at = s.indexOf(head) + if (at < 0) throw new Error(`${file}: no ${name}`) + return JSON.parse(s.slice(at + head.length, s.indexOf('\n} as const', at) + 2)) +} + +/** The one-page view's site path: the course's share path, then ONE_PAGE_DIR; ru/ before it. */ +export const onePagePath = (C, lang, view) => `${lang === 'ru' ? 'ru/' : ''}${C.share}${view.onePageDir}/` + +/** A widget frame's reserved height: the lesson's own, held to the view spec's band. */ +export const frameHeight = (h, view) => Math.min(view.FRAME_MAX_PX, Math.max(view.FRAME_MIN_PX, Number(h) || view.FRAME_MIN_PX)) + +/** A widget page on this site, framed with its words in the reader's language. */ +const framed = (preview, lang) => `/${preview}${lang === 'ru' && preview.startsWith('widgets/') ? `${preview.includes('?') ? '&' : '?'}lang=ru` : ''}` + +/** The TRI CLAW block, the same three paths as the app's footer (components/Footer.tsx ClawPromo). */ +export function clawHtml(ladder, lang) { + const say = ladder.say[lang] + const c = ladder.claw + const third = c.githubIsApp ? ['CLAW_APP_TITLE', 'CLAW_APP_LINE', 'CLAW_APP_PRESS'] : ['CLAW_POST_TITLE', 'CLAW_POST_LINE', 'CLAW_POST_PRESS'] + const paths = [ + ['keys', say.CLAW_FREE_TITLE, say.CLAW_FREE_LINE, say.CLAW_FREE_PRESS, c.keys, true], + ['club', say.CLAW_PAID_TITLE, say.CLAW_PAID_LINE, say.CLAW_PAID_PRESS, c.club, false], + ['github', ...third.map((k) => say[k]), c.github, false], + ] + return `` +} + +/** The TRI CLAW block's look: one stylesheet for the app's footer (components/Footer.tsx imports + * it) and for every static course page (inlined here). */ +export const CLAW_CSS = readFileSync(new URL('../src/styles/claw.css', import.meta.url), 'utf8').replace(/\/\*[\s\S]*?\*\/\n?/g, '').trim() + +/** The lessons of one course, as the course-deck widget reads them: words in both languages. */ +export function deckData(C, view) { + const both = (pick) => Object.fromEntries(C.locales.map((l) => [l, pick(l)])) + return { + id: C.id, + route: C.route, + title: both((l) => C.say[l].TITLE), + onePage: both((l) => `/${onePagePath(C, l, view)}`), + modules: C.modules.map((m) => ({ + n: m.n, + title: both((l) => m[l].title), + lessons: m.lessons.map((id) => { + const l = C.lessons.find((x) => x.id === id) + return { id, n: l.n, title: both((g) => l[g].title), goal: both((g) => l[g].goal), frame: l.widget.preview, widget: l.widget.title, height: frameHeight(l.widget.height, view) } + }), + })), + } +} + +/** + * The page. `share(url, source)` tags a link that leaves for another site (src/lib/shareTags.ts); + * `poolV` stamps frame-pool.js; `viewCss` is src/styles/courseView.generated.css. + */ +export function onePageHtml(C, lang, { view, ladder, cardUrl, share, poolV, viewCss, origin, carryUtm }) { + const say = C.say[lang] + const vs = view.say[lang] + const ls = ladder.say[lang] + const other = lang === 'en' ? 'ru' : 'en' + const total = C.lessons.length + const url = `${origin}/${onePagePath(C, lang, view)}` + const title = fmt(vs.ONE_PAGE_TITLE, say.TITLE) + const alt = `${say.TITLE}. ${vs.ONE_PAGE_LINE}` + const lessonUrl = (l) => `${origin}/${lang === 'ru' ? 'ru/' : ''}learn/${l.id}/` + const courseUrl = `${origin}/${lang === 'ru' ? 'ru/' : ''}${C.share}` + const ld = [ + { + '@context': 'https://schema.org', '@type': 'Course', name: say.TITLE, description: say.DESCRIPTION, url, inLanguage: lang, isAccessibleForFree: true, + provider: { '@type': 'Organization', name: 'TRINITY S³AI', url: `${origin}/` }, + hasPart: C.lessons.map((l) => ({ '@type': 'LearningResource', name: l[lang].title, url: lessonUrl(l), position: l.n })), + }, + { '@context': 'https://schema.org', '@type': 'BreadcrumbList', itemListElement: [ + { '@type': 'ListItem', position: 1, name: 't27.ai', item: `${origin}/${lang === 'ru' ? 'ru/' : ''}` }, + { '@type': 'ListItem', position: 2, name: say.TITLE, item: courseUrl }, + { '@type': 'ListItem', position: 3, name: vs.ONE_PAGE, item: url }, + ] }, + { '@context': 'https://schema.org', '@type': 'ItemList', itemListElement: C.lessons.map((l) => ({ '@type': 'ListItem', position: l.n, url: `${url}#lesson-${l.n}`, name: l[lang].title })) }, + ] + const enc = encodeURIComponent + const net = (source, href) => href(enc(share(url, source))) + const shareRow = `
${esc(vs.SHARE_PAGE)}XTelegramLinkedIn
` + const tocList = `
    ${C.modules + .map((m) => `
  1. ${pad(m.n)} · ${esc(m[lang].title)}
      ${m.lessons + .map((id) => C.lessons.find((l) => l.id === id)) + .map((l) => `
    1. ${pad(l.n)} ${esc(l[lang].title)}
    2. `) + .join('')}
  2. `) + .join('')}
` + const lessonHtml = (l) => { + const t = l[lang] + const h = frameHeight(l.widget.height, view) + const spec = l.spec ? `${esc(say.SPEC)}: ${esc(l.spec.path)} ↗` : '' + return `` + } + const modules = C.modules + .map((m) => `

${esc(fmt(say.MODULE, m.n))} · ${esc(m[lang].title)}

${esc(m[lang].line)}

+${m.lessons.map((id) => lessonHtml(C.lessons.find((l) => l.id === id))).join('\n')} +
`) + .join('\n') + const chain = (to, isNext) => `${isNext ? `${esc(say.NEXT_COURSE)}: ${esc(to.title[lang])} →` : `← ${esc(say.PREV_COURSE)}: ${esc(to.title[lang])}`}` + const words = { PROGRESS: say.PROGRESS, MARK: say.MARK, MARKED: say.MARKED, COPY: vs.COPY, COPIED: vs.COPIED, LESSON: say.LESSON } + const cfg = { live: view.LIVE_FRAMES_MAX, mount: view.MOUNT_MARGIN_PX, unmount: view.UNMOUNT_MARGIN_PX, key: C.progressKey, total } + const V = view + return ` + + + + + +${esc(title)} · t27 + + + + + + + + + + + + + + + + + + + + + + + +${ld.map((x) => ``).join('\n')} + + + +
t27.ai
+
+ +
+
+

${esc(say.KICKER)} · ${esc(vs.ONE_PAGE)}

+

${esc(say.TITLE)}

+

${esc(say.LEAD)}

+

${esc(say.DESCRIPTION)}

+

${esc(ls.LADDER)}

+${shareRow} + +

${esc(fmt(say.PROGRESS, 0, total))}

+

${esc(say.OPEN_COURSE)} →

+
+${modules} + +
+
+ +
${esc(vs.CONTENTS)}
${tocList}
+ + +${carryUtm} + + +` +} diff --git a/apps/website/scripts/course-pages.mjs b/apps/website/scripts/course-pages.mjs index 68a9853897..f72dd49a80 100644 --- a/apps/website/scripts/course-pages.mjs +++ b/apps/website/scripts/course-pages.mjs @@ -19,6 +19,11 @@ // node scripts/course-pages.mjs # write pages + sitemap, render stale cards // node scripts/course-pages.mjs --check # CI: pages current, every card present and current // +// Each course also has its whole course on one page (scripts/course-onepage.mjs): +// all/, with its own card, and the course-deck widget's data for it +// (public/widgets/course-deck/courses/.json). Every page here ends with the +// TRI CLAW block (specs/ladder/course-ladder.t27). +// // Cards are PNGs rendered by headless Chromium (as scripts/og-image.mjs does) // and committed; public/learn/cards.json records what each was drawn from, so // --check can tell a stale card without a browser. @@ -29,6 +34,9 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, wri import { tmpdir } from 'node:os' import { dirname, join, relative } from 'node:path' import { fileURLToPath, pathToFileURL } from 'node:url' +import { CLAW_CSS, clawHtml, deckData, esc, fmt, loadConst, onePageHtml, onePagePath, pad, snippet } from './course-onepage.mjs' +// t27-plumbing: the app's own share tagger (utm_source=), not a second copy of it. +import { shareTagged } from '../src/lib/shareTags.ts' const SITE = join(dirname(fileURLToPath(import.meta.url)), '..') const PUBLIC = join(SITE, 'public') @@ -36,13 +44,13 @@ const ORIGIN = 'https://t27.ai' const BASE = 'learn' const MANIFEST = join(PUBLIC, BASE, 'cards.json') const CARD = { width: 1200, height: 630, maxBytes: 600_000 } +const VIEW = loadConst(join(SITE, 'src/lib/courseView.generated.ts'), 'VIEW') +const LADDER = loadConst(join(SITE, 'src/lib/courseLadder.generated.ts'), 'LADDER') +const VIEW_CSS = join(SITE, 'src/styles/courseView.generated.css') +const POOL = join(PUBLIC, 'widgets/frame-pool.js') +export const DECK_DIR = join(PUBLIC, 'widgets', VIEW.deckWidget, 'courses') const sha = (b) => createHash('sha256').update(b).digest('hex') -const esc = (s) => String(s).replace(/&/g, '&').replace(//g, '>').replace(/"/g, '"') -const fmt = (s, ...a) => a.reduce((out, x, i) => out.split(`{${i}}`).join(String(x)), s) -const pad = (n) => String(n).padStart(2, '0') -/** A search snippet: Google shows about 155 characters, so cut at a word before that. */ -const snippet = (s, max = 155) => (s.length <= max ? s : `${s.slice(0, max).replace(/\s+\S*$/, '')}…`) const unesc = (s) => s.replace(/'/g, "'").replace(/"/g, '"').replace(/</g, '<').replace(/>/g, '>').replace(/&/g, '&') /** The widget page's own og:description: the gallery's words for the tool, not a second copy here. */ @@ -88,17 +96,17 @@ function thumbOf(widget) { // Black and white like the course page (owner, 2026-10-05: no green fields or // glows): white type and rules on black, a widget's picture in greyscale. -function cardHtml(C, lang, lesson) { +function cardHtml(C, lang, lesson, onePage = false) { const say = C.say[lang] const font = lang === 'ru' ? `'Helvetica Neue', Arial, sans-serif` : `'Outfit', 'Helvetica Neue', sans-serif` const fonts = pathToFileURL(join(PUBLIC, 'fonts')).href const mod = lesson ? C.modules.find((m) => m.id === lesson.module) : null const title = lesson ? lesson[lang].title : say.TITLE - const sub = lesson ? lesson[lang].goal : say.LEAD - const kicker = lesson ? `${fmt(say.MODULE, mod.n)} · ${mod[lang].title}` : '' + const sub = lesson ? lesson[lang].goal : onePage ? VIEW.say[lang].ONE_PAGE_LINE : say.LEAD + const kicker = lesson ? `${fmt(say.MODULE, mod.n)} · ${mod[lang].title}` : onePage ? VIEW.say[lang].ONE_PAGE : '' const thumb = lesson ? thumbOf(lesson.widget) : null const cells = C.lessons - .map((l) => ``) + .map((l) => ``) .reduce((out, c, i) => out + (i % 3 === 0 && i ? '' : '') + c, '') const big = title.length > 40 ? 52 : title.length > 22 ? 60 : 72 return `
t27.ai · ${esc(say.KICKER)}${esc(kicker)}
${lesson ? `
${esc(fmt(say.LESSON, pad(lesson.n), C.lessons.length))}
` : ''}

${esc(title)}

${esc(sub)}

${thumb ? `
` : ''}
-
${cells}
t27.ai/${esc(pathOf(C, lang, lesson?.id).replace(/\/$/, ''))}
+
${cells}
t27.ai/${esc((onePage ? onePagePath(C, lang, VIEW) : pathOf(C, lang, lesson?.id)).replace(/\/$/, ''))}
` } @@ -180,7 +188,7 @@ function pageHtml(C, lang, lesson, cardUrl, all = []) {

${esc(say.GOAL)}

${esc(t.goal)}

${esc(t.text)}

${esc(say.TRY)}

${esc(t.task)}

-

${esc(say.OPEN_LESSON)} →

+

${esc(say.OPEN_LESSON)} → ${esc(VIEW.say[lang].ONE_PAGE)} →

${thumb ? `${esc(lesson.widget.title)}` : ''}
${esc(lesson.widget.title)} ↗
${about ? `

${esc(about)}

` : ''} ${lesson.spec ? `

${esc(lesson.spec.path)}

${code ? `
${esc(code)}
` : ''}

${esc(say.SPEC)} ↗

` : ''} @@ -189,7 +197,8 @@ ${lesson.spec ? `

${esc(lesson.spec.path)}

${code ? `
${esc(say.LEAD)}

${esc(say.DESCRIPTION)}

-

${esc(say.OPEN_COURSE)} →

+

${esc(say.OPEN_COURSE)} → ${esc(VIEW.say[lang].ONE_PAGE)} →

+

${esc(LADDER.say[lang].LADDER)}

${catalog}${courses}` return ` @@ -243,14 +252,17 @@ figcaption { font-size: 15px; margin-top: 8px; } pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +${readFileSync(VIEW_CSS, 'utf8').replace(/\/\*[\s\S]*?\*\/\n?/g, '')}${CLAW_CSS} @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.ai${other === 'ru' ? 'Русский' : 'English'}
${body}

${esc(say.ALL)}

    ${outline}
+${clawHtml(LADDER, lang)}
${CARRY_UTM} @@ -274,6 +286,13 @@ export function buildPages(courses, manifest = {}) { const cardUrl = `${ORIGIN}/${dir}card.png?v=${v}` pages.push({ course: C, lang, lesson, dir, card, input: cardInput(card), png, html: pageHtml(C, lang, lesson, cardUrl, courses), drawn: manifest[dir] }) } + // The whole course on one page, with its own card. + const dir = onePagePath(C, lang, VIEW) + const card = cardHtml(C, lang, null, true) + const png = join(PUBLIC, dir, 'card.png') + const v = existsSync(png) ? sha(readFileSync(png)).slice(0, 12) : 'missing' + const html = onePageHtml(C, lang, { view: VIEW, ladder: LADDER, cardUrl: `${ORIGIN}/${dir}card.png?v=${v}`, share: (url, source) => shareTagged(url, source, 'course', C.route), poolV: sha(readFileSync(POOL)).slice(0, 12), viewCss: readFileSync(VIEW_CSS, 'utf8'), origin: ORIGIN, carryUtm: CARRY_UTM }) + pages.push({ course: C, lang, lesson: null, onePage: true, dir, card, input: cardInput(card), png, html, drawn: manifest[dir] }) } } const dirs = pages.map((p) => p.dir) @@ -288,15 +307,23 @@ export function sitemapOf(pages) { ${pages.map((p) => { const id = p.lesson?.id - return ` ${urlOf(p.course, p.lang, id)}${['en', 'ru'].map((h) => ``).join('')}` + const at = (lang) => (p.onePage ? `${ORIGIN}/${onePagePath(p.course, lang, VIEW)}` : urlOf(p.course, lang, id)) + return ` ${at(p.lang)}${['en', 'ru'].map((h) => ``).join('')}` }).join('\n')} ` } +/** The course-deck widget's data: the catalog, then one file per course, [[path, text]]. */ +export const deckFiles = (courses) => [ + [join(DECK_DIR, 'index.json'), `${JSON.stringify(courses.map((C) => ({ id: C.id, title: Object.fromEntries(C.locales.map((l) => [l, C.say[l].TITLE])) })))}\n`], + ...courses.map((C) => [join(DECK_DIR, `${C.id}.json`), `${JSON.stringify(deckData(C, VIEW))}\n`]), +] + /** What is wrong with the pages on disk; empty when current. */ -export function problemsOf(pages, sitemap) { +export function problemsOf(pages, sitemap, decks = []) { const p = [] + for (const [f, text] of decks) if (!existsSync(f) || readFileSync(f, 'utf8') !== text) p.push(`${relative(SITE, f)} is not current; run node scripts/course-pages.mjs`) for (const pg of pages) { const f = join(PUBLIC, pg.dir, 'index.html') if (!existsSync(f) || readFileSync(f, 'utf8') !== pg.html) p.push(`public/${pg.dir}index.html is not current; run node scripts/course-pages.mjs`) @@ -366,13 +393,15 @@ async function main() { writeFileSync(join(PUBLIC, p.dir, 'index.html'), p.html) } writeFileSync(join(PUBLIC, BASE, 'sitemap.xml'), sitemapOf(pages)) + mkdirSync(DECK_DIR, { recursive: true }) + for (const [f, text] of deckFiles(courses)) writeFileSync(f, text) } - const problems = problemsOf(pages, sitemapOf(pages)) + const problems = problemsOf(pages, sitemapOf(pages), deckFiles(courses)) if (problems.length) { console.error(problems.join('\n')) process.exit(1) } - console.log(`course-pages: ${check ? 'up to date' : 'wrote'} ${pages.length} pages for ${courses.length} courses (${courses.map((c) => c.id).join(', ')}), ${pages.length} cards, ${BASE}/sitemap.xml`) + console.log(`course-pages: ${check ? 'up to date' : 'wrote'} ${pages.length} pages for ${courses.length} courses (${courses.map((c) => c.id).join(', ')}), ${pages.filter((p) => p.onePage).length} of them whole courses on one page, ${pages.length} cards, ${courses.length + 1} course-deck files, ${BASE}/sitemap.xml`) } if (process.argv[1] === fileURLToPath(import.meta.url)) await main() diff --git a/apps/website/scripts/course-pages.test.mjs b/apps/website/scripts/course-pages.test.mjs index b0c6912334..efc1fcdec7 100644 --- a/apps/website/scripts/course-pages.test.mjs +++ b/apps/website/scripts/course-pages.test.mjs @@ -1,13 +1,18 @@ import assert from 'node:assert/strict' import { test } from 'node:test' -import { appOf, buildPages, loadCourses, sitemapOf } from './course-pages.mjs' +import { existsSync, readFileSync } from 'node:fs' +import { appOf, buildPages, deckFiles, loadCourses, sitemapOf } from './course-pages.mjs' +import { frameHeight, loadConst, onePagePath } from './course-onepage.mjs' const COURSES = loadCourses() const pages = buildPages(COURSES) const meta = (html, key) => html.match(new RegExp(` { - assert.equal(pages.length, COURSES.reduce((n, C) => n + C.locales.length * (C.lessons.length + 1), 0)) +const VIEW = loadConst(new URL('../src/lib/courseView.generated.ts', import.meta.url), 'VIEW') +const LADDER = loadConst(new URL('../src/lib/courseLadder.generated.ts', import.meta.url), 'LADDER') + +test('one page per lesson, one per course and one whole course on one page, in every language', () => { + assert.equal(pages.length, COURSES.reduce((n, C) => n + C.locales.length * (C.lessons.length + 2), 0)) for (const C of COURSES) for (const l of C.lessons) for (const lang of C.locales) assert.ok(pages.some((p) => p.lang === lang && p.lesson?.id === l.id)) assert.equal(new Set(pages.map((p) => p.dir)).size, pages.length) }) @@ -15,7 +20,7 @@ test('one page per lesson and one per course, in every language', () => { test('each course has its own share page, and the first course keeps learn/', () => { assert.equal(COURSES[0].share, 'learn/') for (const C of COURSES) for (const lang of C.locales) { - const index = pages.find((p) => p.course.id === C.id && p.lang === lang && !p.lesson) + const index = pages.find((p) => p.course.id === C.id && p.lang === lang && !p.lesson && !p.onePage) assert.equal(index.dir, `${lang === 'ru' ? 'ru/' : ''}${C.share}`) } }) @@ -63,6 +68,7 @@ test('JSON-LD parses, names the page and carries its breadcrumbs', () => { const ld = [...p.html.matchAll(/ diff --git a/apps/website/public/learn/a-bend-at-zero/index.html b/apps/website/public/learn/a-bend-at-zero/index.html index 1d2141bf1b..f2d42edecf 100644 --- a/apps/website/public/learn/a-bend-at-zero/index.html +++ b/apps/website/public/learn/a-bend-at-zero/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A bend at zero

You will learn

Why a ReLU needs a test with a negative input before anyone can say it bends.

A neuron passes its sum through an activation, and in gft_relu.t27 that is relu(x) = max(0, x). on_comb returns 0 for zero and for any input with the sign bit set, and x itself otherwise. The header says ReLU has an exact 0/1 gradient and that a 2-layer ReLU net solves XOR, which a linear GF-T model cannot. The browser skips all 4 tests because its runner does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that lets negative inputs through, which turns relu into the identity, a straight line, and t27c test-report again. Exactly one test fails, negz; no other test has a negative input. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the value negz expects; then in the spec frame find the comment on that line and check whether it still describes the code after the change.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_relu.t27 -- a bend at zero, native
t27c on gft_relu.t27 -- a bend at zero, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; letting negative inputs through makes exactly one test fail, negz; git restores the spec.

specs/ternary/gft_relu.t27

module GftRelu;
@@ -92,6 +124,7 @@ 

A bend at zero

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-boundary-of-real-files/index.html b/apps/website/public/learn/a-boundary-of-real-files/index.html index e951298165..a24003c3a5 100644 --- a/apps/website/public/learn/a-boundary-of-real-files/index.html +++ b/apps/website/public/learn/a-boundary-of-real-files/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A boundary of real files

You will learn

Which proposed paths a task may reserve, and why one invented path stops the whole shape.

A task's boundary is a reservation: while a bee works, no other bee takes those files. So a wrong boundary is worse than a missing one, because it holds files the work does not own. path_accepted takes any file that exists, and a new file only when its folder exists, the issue cites it, and its language is one the only-t27 rule allows. shape_lands writes the shape back only when no section is missing, it names 1 to 12 paths, and none of them was refused.

Try it

Make the two red paths green by changing only facts that could be true; then leave a section missing and watch the gate.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A boundary: which files a task may reserve
A boundary: which files a task may reserve ↗

Four paths a model proposed for an issue. Tap what is true of each: the spec accepts or refuses it, and a shape lands only when every path holds.

specs/queen/shaping.t27

// SPDX-License-Identifier: Apache-2.0
@@ -198,6 +230,7 @@ 

A boundary of real files

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-build-receipt/index.html b/apps/website/public/learn/a-build-receipt/index.html index 706b7795dd..1de041de9b 100644 --- a/apps/website/public/learn/a-build-receipt/index.html +++ b/apps/website/public/learn/a-build-receipt/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A build, itemised

You will learn

Every stage from a spec to a bitstream, with its time, tool and hash.

A whole build from a t27 spec to an Artix-7 bitstream, written out like a shop receipt: each stage, the tool and its version, the time it took, and the sha256 of what it wrote. No Vivado anywhere. When a number on a receipt can be checked, anyone can rebuild it and compare the hash.

Try it

Read the receipt: which stage took the longest, and which tool ran it? In the spec frame, RECEIPT_KINDS names two kinds of receipt: which one is the build alone, and which entry in ERRORS catches it posing as the other?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Build receipt: t27 spec to XC7A200T bitstream, no Vivado
Build receipt: t27 spec to XC7A200T bitstream, no Vivado ↗

One real open-flow build itemised like a shop receipt: each stage from a t27 spec to an Artix-7 200T bitstream with its time, tool version, output size and sha256.

specs/fpga/adapter.t27

// SPDX-License-Identifier: Apache-2.0
@@ -168,6 +200,7 @@ 

A build, itemised

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-correlator-finds-the-frame/index.html b/apps/website/public/learn/a-correlator-finds-the-frame/index.html index 2f73933559..0b58302d18 100644 --- a/apps/website/public/learn/a-correlator-finds-the-frame/index.html +++ b/apps/website/public/learn/a-correlator-finds-the-frame/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A correlator finds the frame

You will learn

How a Barker-13 correlator finds the start of a frame, and how many flipped chips it survives.

A frame starts with the 13 chips of the Barker code, whose correlation with itself is 13 lined up and at most 1 shifted. The modem spec bpsk.t27 pushes each received chip into a 13-chip window and correlates it; it locks at 9, well between sidelobe and peak. The widget runs those very functions on a stream of 32 chips: the peak stands at 13 where the preamble lines up, an inverted carrier gives -13, and every flipped chip in the window lowers the peak by 2.

Try it

Flip two chips of the preamble and check that it still locks; then find how many flips stop the lock.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A correlator finds the frame: Barker-13 in a stream of chips
A correlator finds the frame: Barker-13 in a stream of chips ↗

Slide a Barker-13 preamble through a stream of chips and watch the correlator peak at 13 where it lines up. Flip chips to add noise; see when the lock fails.

specs/fpga/bpsk.t27

// SPDX-License-Identifier: Apache-2.0
@@ -282,6 +314,7 @@ 

A correlator finds the frame

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-deploy-mid-flight/index.html b/apps/website/public/learn/a-deploy-mid-flight/index.html index ca7b1518fd..91bb4774c8 100644 --- a/apps/website/public/learn/a-deploy-mid-flight/index.html +++ b/apps/website/public/learn/a-deploy-mid-flight/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A deploy mid-flight

You will learn

What a redeploy does to a bee, a review, a round, a job and a wait.

Every merge redeploys the Queen, and work is running when it does. drain.t27 sorts that work. A round, a job step and a wait row are rows the store keeps: the process leaves them and the next process carries on. A review is stopped, because a stop loses at most one review, which is redone. A bee is held, because what it has done lives in its conversation; at the cap, drain_cap_seconds, 1800 s today, it is handed back and its work is salvaged into its branch.

Try it

Drag the wait from 0 to the cap and watch the bee's row change; then cut the platform drain to 1000 s.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A deploy mid-flight: what happens to a running bee
A deploy mid-flight: what happens to a running bee ↗

The Queen is redeployed while work runs. Drag how long the drain has waited: a bee is held to the cap and then handed back, a review is stopped, a round and a job are left to the store.

specs/queen/drain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -389,6 +421,7 @@ 

A deploy mid-flight

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-dot-product-in-wires/index.html b/apps/website/public/learn/a-dot-product-in-wires/index.html index fc1684a800..bb33496e82 100644 --- a/apps/website/public/learn/a-dot-product-in-wires/index.html +++ b/apps/website/public/learn/a-dot-product-in-wires/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A dot product made of wires

You will learn

What on_comb turns a spec into, and how one wrong sign in tmul shows up in exactly one test.

on_comb in comb_ternary_dot.t27 is combinational: the generated Verilog drives result with one assign and no register, so the output follows the inputs. It adds tp over all 27 lanes of a and b, and tp calls tmul, which returns 0 if either trit is Z, +1 if they match and -1 otherwise. So N times N is +1, and dot_all_n_x_all_n expects 27. The browser skips all 4 tests because it does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording changes return -1 to return 1 on line 22, and exactly one test fails, dot_all_n_x_all_p, the one test that sets N against P. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the tmul line that changes and the test that fails; then in the spec frame find dot_all_n_x_all_n and explain why it expects 27 and not -27.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on comb_ternary_dot.t27 -- The dot product as wires, native
t27c on comb_ternary_dot.t27 -- The dot product as wires, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 4 tests pass natively; tmul returning +1 for mismatched signs fails exactly one test, dot_all_n_x_all_p; git restores the spec.

specs/ternary/comb_ternary_dot.t27

module CombTernaryDot;
@@ -111,6 +143,7 @@ 

A dot product made of wires

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-float-cut-by-phi/index.html b/apps/website/public/learn/a-float-cut-by-phi/index.html index 0ad865ec78..9511a6c373 100644 --- a/apps/website/public/learn/a-float-cut-by-phi/index.html +++ b/apps/website/public/learn/a-float-cut-by-phi/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A float cut by phi

You will learn

How one rule, E = round((N - 1) / phi^2), splits every GoldenFloat width into sign, exponent and mantissa.

A float spends its bits on three fields: one sign bit, an exponent for range and a mantissa for precision. IEEE 754 picks the split by committee for each width. GoldenFloat uses one rule for all of them: of the N - 1 bits after the sign, round((N - 1) / phi^2) go to the exponent and the rest to the mantissa, so the ratio E / M stays near 1 / phi, about 0.618. The family spec lists 17 widths from GF4 to GF1024, and GF16 is the one it marks primary.

Try it

Run the tests of goldenfloat_family.t27 and find the one that counts the family. Then find which format the spec marks primary and the test that says only one is.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 1: one rule for every width
GoldenFloat 1: one rule for every width ↗

Five of the 17 GoldenFloat widths, read from goldenfloat_family.t27. Lesson 1 of the GoldenFloat course.

specs/numeric/goldenfloat_family.t27

// SPDX-License-Identifier: Apache-2.0
@@ -627,6 +659,7 @@ 

A float cut by phi

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-key-rests/index.html b/apps/website/public/learn/a-key-rests/index.html index 9c2fe30129..5601ab6bee 100644 --- a/apps/website/public/learn/a-key-rests/index.html +++ b/apps/website/public/learn/a-key-rests/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A key rests

You will learn

How long a refused key rests before a bee may use it again.

A transient refusal rests the key COOL_BASE_SECONDS, 15 s, doubled per strike in a row and never more than COOL_CAP_SECONDS, 240 s: 15, 30, 60, 120, 240. A spent quota or a refused key closes it for KEY_BREAK_SECONDS, 1800 s. cooldown_seconds gives all of it. The rest is short so that 34 keys are never all resting through a one-minute burst like the one of 2026-10-17.

Try it

Find the strike count where the rest stops growing; then switch to quota and read the rest.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

How long a refused key rests
How long a refused key rests ↗

A transient refusal rests the key 15 s, doubled per strike in a row, never past 240 s. A spent quota or a refused key closes it for 1800 s. Drag the strikes.

specs/queen/key_failover.t27

// SPDX-License-Identifier: Apache-2.0
@@ -451,6 +483,7 @@ 

A key rests

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-loss-in-bits/index.html b/apps/website/public/learn/a-loss-in-bits/index.html index db43b3a6ea..63b703dd28 100644 --- a/apps/website/public/learn/a-loss-in-bits/index.html +++ b/apps/website/public/learn/a-loss-in-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A loss in bits

You will learn

How the loss -log2(p) prices a guess in bits, and why a perfect guess must cost exactly 0.

Training starts with a number for how wrong a guess was. gft_nll.t27 takes p, the probability the model gave the true class, and returns -log2(p): p = 1.0 costs 0, p = 0.5 costs 1 bit, and p = 0.25 costs 2. on_comb is neg(log2v(p)), and neg flips the sign bit, except that it returns 0 for 0. One header line still says the output is log2(x); the code returns its negative. The browser skips all 3 tests because its runner does not know assert_eq yet; the native t27c runs all 3, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that makes neg return 65536 for 0, a zero with the sign bit set, and t27c test-report again: exactly one test fails, perfect. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find the header line that says the output is log2(x) and compare it with on_comb.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_nll.t27 -- a loss in bits, native
t27c on gft_nll.t27 -- a loss in bits, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 3 tests pass natively, none vacuous; a zero with the sign bit set from neg makes exactly one test fail, perfect; git restores the spec.

specs/ternary/gft_nll.t27

module GftNll;
@@ -170,6 +202,7 @@ 

A loss in bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-model-on-the-board/index.html b/apps/website/public/learn/a-model-on-the-board/index.html index b9caad40ea..10d8b89fc3 100644 --- a/apps/website/public/learn/a-model-on-the-board/index.html +++ b/apps/website/public/learn/a-model-on-the-board/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A model's tables on the board

You will learn

How the host feeds the board over a serial bridge, why the window size matters, and what the board computed.

The board does the arithmetic; the host sends it work over a USB serial bridge. The board's answers wait in the bridge chip's small receive buffer, and when the host keeps more requests in flight than their answers fit, answers are lost. A smaller window removed the loss and did not slow the run. Over that link the board multiplied every ternary weight matrix of a small language model, and every row matched the reference bit for bit. The text itself is generated on the Mac, which does everything except the ternary dot products: the board is the calculator, not the whole model.

Try it

Drag the window until the bucket overflows and note the largest window that fits; then compare the two real runs. In the spec frame, weighted applies a weight by its sign alone; find apply_alpha, where each layer multiplies once, and the test that shows it rounds down.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The bucket under the tap: a 512-byte UART buffer and 19-byte answers
The bucket under the tap: a 512-byte UART buffer and 19-byte answers ↗

Drag the number of requests in flight and watch the answers fill a CP2102N's 512-byte receive buffer, then read the measured runs on the AX7203 board.

specs/igla/race/unit_weights_node.t27

// SPDX-License-Identifier: Apache-2.0
@@ -314,6 +346,7 @@ 

A model's tables on the board

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-neuron-in-chunks/index.html b/apps/website/public/learn/a-neuron-in-chunks/index.html index b755833d35..a3395b6f4d 100644 --- a/apps/website/public/learn/a-neuron-in-chunks/index.html +++ b/apps/website/public/learn/a-neuron-in-chunks/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A neuron in chunks

You will learn

How a neuron with more than 27 inputs adds up its dot products chunk by chunk, and why a test with zero chunks matters.

One packed chunk holds 27 trits, so a wider neuron needs several. neuronN in bitnet_neuron_nchunk.t27 takes up to 8 chunks of activations and weights, adds dot27 for nchunks pairs starting at chunk 0, and quantizes the total. The browser skips all 11 tests because it does not know assert_eq yet; the native t27c runs all 11, all pass, none vacuous. The recording changes the loop bound on line 36 from nchunks to 1, so the neuron always reads exactly one chunk. The other neuron tests fill every chunk alike, so one chunk lands on the same side of the threshold. Exactly one test fails, neuron_zero_chunks, which asks for no chunks and expects Z. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the loop line before and after the change; then in the spec frame find neuron_two_chunks and explain why the same bug does not break it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on bitnet_neuron_nchunk.t27 -- A neuron over N chunks, native
t27c on bitnet_neuron_nchunk.t27 -- A neuron over N chunks, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 11 tests pass natively; stopping the chunk loop after one chunk fails exactly one test, neuron_zero_chunks; git restores the spec.

specs/ternary/bitnet_neuron_nchunk.t27

module BitnetNeuronN;
@@ -139,6 +171,7 @@ 

A neuron in chunks

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-pass-that-checked-nothing/index.html b/apps/website/public/learn/a-pass-that-checked-nothing/index.html index 9cec7764bd..53c8de1b41 100644 --- a/apps/website/public/learn/a-pass-that-checked-nothing/index.html +++ b/apps/website/public/learn/a-pass-that-checked-nothing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A pass that checked nothing

You will learn

What a vacuous pass is, why a green report can hide one, and how a planted bug tells real checks from empty ones.

The native t27c runs all 13 tests of gfternary.t27, and all 13 pass. The same report prints a line most tools never do: 8 of the 13 passed with no runtime assert executed. A vacuous pass is not a lie, but it is not evidence either. The 5 invariants are proved while the spec compiles, and one of them asserts only true, a placeholder. So the recording plants a bug: the reserved code 11 is no longer folded to zero. Exactly one test fails, the one written for that rule. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find the vacuous-pass line and the test the planted bug breaks; then open the spec and find the invariant that asserts only true.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gfternary.t27 -- phi-scaled ternary weights, native
t27c on gfternary.t27 -- phi-scaled ternary weights, native ↗

t27c 0.4.0 and zig 0.16.0 on the t27c lab (Railway), spec at t27 5ff0ec512: 13 tests pass natively, 8 of them with no runtime assert; dropping the reserved-code fold makes exactly one test fail; git restores the spec.

specs/numeric/gfternary.t27

// SPDX-License-Identifier: Apache-2.0
@@ -452,6 +484,7 @@ 

A pass that checked nothing

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-recurrent-cell/index.html b/apps/website/public/learn/a-recurrent-cell/index.html index 0eca5288aa..3f22a96c99 100644 --- a/apps/website/public/learn/a-recurrent-cell/index.html +++ b/apps/website/public/learn/a-recurrent-cell/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A recurrent cell

You will learn

How a recurrent cell carries a state from step to step, and why that memory fades.

A sentence comes one word at a time, and a recurrent cell carries a state h from one step to the next: h' = tanh(W_x x + W_h h + b). In the spec's tiny cell W_x is 1 and W_h 0.5, so a single pulse gives 0.7616, 0.3634 and 0.1797: the memory of it roughly halves each step. A second pulse at step 3 lifts h to 0.7968, a little above where the single pulse began, because the old memory is still there. After 8 steps only 0.0466 is left. That fading is why plain cells forget long contexts. The spec rnn_cell.t27 computes each step.

Try it

Load one pulse and read how many steps it takes to fall under 0.1; then make the input alternate.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Recurrent cells: how a network remembers a moment ago
Recurrent cells: how a network remembers a moment ago ↗

Tap the inputs of eight steps: the cell feeds its own last output back, h' = tanh(x + 0.5 h), so every pulse echoes on and fades by about half a step. Two pulses add up.

specs/ml/recurrent/rnn_cell.t27

// SPDX-License-Identifier: Apache-2.0
@@ -258,6 +290,7 @@ 

A recurrent cell

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-refused-key/index.html b/apps/website/public/learn/a-refused-key/index.html index a35990896e..5648e8e090 100644 --- a/apps/website/public/learn/a-refused-key/index.html +++ b/apps/website/public/learn/a-refused-key/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A refused key

You will learn

How the Queen sorts a provider's refusal into transient, quota, auth or a bad request.

Bees call models with keys, and keys get refused. key_failover.t27 sorts each refusal with error_kind. The z.ai code in the body wins over the HTTP status, because z.ai sends a spent quota and a passing overload with the same 429: code 1305 is transient, 1113 is quota. No answer at all is transient. A quota or auth refusal closes the key, and only a bad request is charged to the issue.

Try it

Compare 429 with codes 1308 and 1312; then read what no answer at all is.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A refused key: transient, quota, auth or a bad request
A refused key: transient, quota, auth or a bad request ↗

Pick the HTTP status and the z.ai code a bee got back. error_kind sorts the refusal, and the grid colours every status against every code the same way.

specs/queen/key_failover.t27

// SPDX-License-Identifier: Apache-2.0
@@ -451,6 +483,7 @@ 

A refused key

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-sign-is-one-bit/index.html b/apps/website/public/learn/a-sign-is-one-bit/index.html index b66ceedbd4..1c80ed57eb 100644 --- a/apps/website/public/learn/a-sign-is-one-bit/index.html +++ b/apps/website/public/learn/a-sign-is-one-bit/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A sign is one bit

You will learn

How a signed multiply sets the sign of its product, and which test notices when it never does.

Modules 1 to 4 were about storing numbers: the T27 cell, the OCP MX scale byte, ternary weights scaled by phi, and TNF; this module makes them do arithmetic. gft_smul.t27 uses the bits of tnf17.t27: 1.0 is 20480, and -1.0 is 86016, the same bits plus the sign bit 65536. smul sets the sign when the two input signs differ and leaves the size to magmul. The browser skips all 3 tests because its runner does not know assert_eq yet; the native t27c runs all 3, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that makes the sign always 0, and t27c test-report again: exactly one test fails, m2, which multiplies 1.0 by -1.0. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find m1 and m3 and work out why a sign that is always 0 cannot break them.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_smul.t27 -- a sign is one bit, native
t27c on gft_smul.t27 -- a sign is one bit, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 3 tests pass natively, none vacuous; a sign that is always 0 makes exactly one test fail, m2; git restores the spec.

specs/ternary/gft_smul.t27

module GftSmul;
@@ -190,6 +222,7 @@ 

A sign is one bit

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-small-program/index.html b/apps/website/public/learn/a-small-program/index.html index ea305f335b..0de6177645 100644 --- a/apps/website/public/learn/a-small-program/index.html +++ b/apps/website/public/learn/a-small-program/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A small complete program

You will learn

How the pieces of this course make one spec that becomes a circuit.

The lesson spec has a module line, a width constant, test values and on_comb, a function of two u8 inputs. gen-verilog turns it into a module whose ports are a clock, a reset and an enable, the two 8-bit inputs a and b, a ready output and the 8-bit output result. An assign line sets result from on_comb, so the sum itself waits for no clock edge. The tests check the example sums as constants; the site runner does not call on_comb, so the check of the circuit itself is left to a simulator.

Try it

Open the verilog tab of the lesson spec in the player and find the input, output and assign lines.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 26: an adder in t27 and its Verilog ports
t27 basics 26: an adder in t27 and its Verilog ports ↗

An 8-bit adder written in t27, with the Verilog ports and assign line the real compiler wrote for it. Lesson 26 of the t27 basics course.

specs/basics/26_a_small_program.t27

// SPDX-License-Identifier: Apache-2.0
@@ -87,6 +119,7 @@ 

A small complete program

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-tasks-life/index.html b/apps/website/public/learn/a-tasks-life/index.html index 004d2d6798..0934d56aec 100644 --- a/apps/website/public/learn/a-tasks-life/index.html +++ b/apps/website/public/learn/a-tasks-life/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A task's life

You will learn

Which states a dispatched task passes through, and which events are legal in each.

dispatch.t27 is the Queen's task lifecycle, the cycle that chooses, starts, ends, reviews and releases work. A task has 12 states and 16 events. next_state answers every pair, and 99 means the event is illegal in that state: a verdict cannot reach a running task, and a reap cannot reach an ended one. After a verdict a send-back waits for its floor and is released; even an accept is sent back if CI turns red under the ceiling.

Try it

Walk a task from none to accept; then make CI red at the ceiling and find the one way out.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A task's life: the Queen's state machine
A task's life: the Queen's state machine ↗

Twelve states and sixteen events. Tap an event: next_state moves the task, and every event it would refuse is greyed out.

specs/queen/dispatch.t27

// SPDX-License-Identifier: Apache-2.0
@@ -662,6 +694,7 @@ 

A task's life

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-ternary-alu/index.html b/apps/website/public/learn/a-ternary-alu/index.html index 7853b2ed50..c10d99371c 100644 --- a/apps/website/public/learn/a-ternary-alu/index.html +++ b/apps/website/public/learn/a-ternary-alu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A ternary ALU

You will learn

How add, subtract, negate and compare work on 9-trit registers.

The ALU of this widget is built from the course so far: ADD is the ripple adder, SUB adds b with every trit flipped, NEG is the flip alone, CMP answers one trit. Nine-trit registers hold -9841 to 9841, and a result beyond that is flagged as overflow. The lesson spec, tri27_machine.t27, states the TRI-27 machine as the Trinity emulator executes it.

Try it

Subtract 13 from 40 and read the tiles; then make the adder overflow with the smallest pair you can.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A ternary ALU built from this course's adders
A ternary ALU built from this course's adders ↗

Add, subtract, negate and compare 9-trit registers. Subtraction is a flip and an add; an overflow past 9 trits is flagged.

specs/isa/tri27_machine.t27

// SPDX-License-Identifier: Apache-2.0
@@ -533,6 +565,7 @@ 

A ternary ALU

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-test-block/index.html b/apps/website/public/learn/a-test-block/index.html index 050ac75495..6e9b7cf5d6 100644 --- a/apps/website/public/learn/a-test-block/index.html +++ b/apps/website/public/learn/a-test-block/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A test block

You will learn

How a test block is written and what a failing assert reports.

A test block starts with the keyword test and a name, and holds assert lines in braces. Each assert takes an expression that must be true. When one is false, the report names the test and the number of the assert, for example assert #1 is false. A spec's tests are its claims about itself, which is why every course spec on this site carries some.

Try it

Break the test on purpose by changing DAYS, then read the failure line.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 10: a test block, passing and failing
t27 basics 10: a test block, passing and failing ↗

A t27 test block and the report it gives when it passes and when an assert is false. Lesson 10 of the t27 basics course.

specs/basics/10_a_test_block.t27

// SPDX-License-Identifier: Apache-2.0
@@ -80,6 +112,7 @@ 

A test block

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-tiny-layer/index.html b/apps/website/public/learn/a-tiny-layer/index.html index acdf023068..f7b77e73ff 100644 --- a/apps/website/public/learn/a-tiny-layer/index.html +++ b/apps/website/public/learn/a-tiny-layer/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A tiny layer

You will learn

How several neurons reading one input describe it with a few trits.

A layer is several neurons that read the same input. Three detectors, vertical, horizontal and diagonal, turn a 3 x 3 picture into three output trits: a vertical bar gives +1, 0, 0. Stack layers and you have a network; the lesson spec is a 4-neuron layer in one combinational module, and the ai-numbers course takes it to a whole network on the board.

Try it

Draw a picture that makes two neurons fire at once; then one that makes all three answer -1.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A layer of three ternary neurons
A layer of three ternary neurons ↗

Three neurons share one input: a vertical, a horizontal and a diagonal detector. Draw on the input and read three output trits.

specs/ternary/comb_bitnet_layer.t27

module CombBitnetLayer;
@@ -130,6 +162,7 @@ 

A tiny layer

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-whole-network/index.html b/apps/website/public/learn/a-whole-network/index.html index 37ea6e419f..f20ece1a1f 100644 --- a/apps/website/public/learn/a-whole-network/index.html +++ b/apps/website/public/learn/a-whole-network/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A whole network

You will learn

How the pieces of this course fit into one small network, and what its tests and its Verilog still leave open.

mlp2 in bitnet_mlp.t27 is a whole network: 3 neurons read the input, pack3 packs their 3 trits into a hidden chunk, and 2 neurons turn it into 2 output trits. The course went from number formats and arithmetic to a neuron, training, ternary weights and the chip; here are the neuron, the weights and an on_comb entry, and no training. The native t27c runs all 4 tests, all pass, none vacuous; the browser skips them, and none calls mlp2. The generated Verilog marks the chunk loop in neuronN NOT UNROLLED, and its note says yosys rejects it, so it is not yet a chip. The recording moves the third hidden trit from bit 4 to bit 3 on line 39, and exactly one test fails, pack3_zzz. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the pack3 line before and after the change; then in the spec frame open Code, pick verilog and find the loop in neuronN marked NOT UNROLLED.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on bitnet_mlp.t27 -- A whole ternary network, native
t27c on bitnet_mlp.t27 -- A whole ternary network, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 4 tests pass natively; pack3 writing its third trit one bit low fails exactly one test, pack3_zzz; git restores the spec.

specs/ternary/bitnet_mlp.t27

module BitnetMlp;
@@ -140,6 +172,7 @@ 

A whole network

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/a-word-of-27/index.html b/apps/website/public/learn/a-word-of-27/index.html index 736d891675..6e51e78d2d 100644 --- a/apps/website/public/learn/a-word-of-27/index.html +++ b/apps/website/public/learn/a-word-of-27/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A word of 27 trits

You will learn

How many bits a 27-trit word needs, and how close to full it runs.

k trits need the fewest bits b with 2^b at least 3^k. A 27-trit word, the size of a TRI-27 register, reaches plus or minus 3812798742493 and needs 43 bits. The share of those bits in use climbs in a saw-tooth towards 1 as words grow: wide words waste almost nothing, narrow ones up to a fifth.

Try it

Find the word length above one trit with the worst share, and the one closest to 100%.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A word of 27 trits and the 43 bits it needs
A word of 27 trits and the 43 bits it needs ↗

Slide the word length. k trits need the fewest bits b with 2^b >= 3^k; at 27 trits that is 43 bits, and the share in use approaches 100 percent.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

A word of 27 trits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/adam/index.html b/apps/website/public/learn/adam/index.html index e6ffb137ed..08c9ff411f 100644 --- a/apps/website/public/learn/adam/index.html +++ b/apps/website/public/learn/adam/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Adam

You will learn

How Adam combines momentum with a running scale, and why its bias correction makes step 1 a fixed size.

Adam combines the two ideas: m, a running mean of the gradient, as in momentum, and v, a running mean of its square, as in RMSProp; the step is lr m / sqrt(v). Both start at 0 and are too small early on, so Adam divides them by 1 - beta^t, and on step 1 that makes the move exactly lr times the sign of the gradient: gradients 2, -40 and 0.5 all move their weights by 0.001. On the spec's bowl (x - 3)^2 at lr 0.1, Adam rises from 0, overshoots to about 3.18 and settles at 3.00005 by step 200. The spec adam.t27 computes every step.

Try it

Give the three gradients very different sizes and read the weights after step 1; then find where the path tops out.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Adam: the optimizer most networks are trained with
Adam: the optimizer most networks are trained with ↗

Watch Adam carry a weight from 0 to the minimum at 3, then set three gradients of any size: the bias correction makes the first step lr times their sign, whatever their size.

specs/ml/optimizer/adam.t27

// SPDX-License-Identifier: Apache-2.0
@@ -225,6 +257,7 @@ 

Adam

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/add-it-up-every-clock/index.html b/apps/website/public/learn/add-it-up-every-clock/index.html index 085552be4d..69d0f98e58 100644 --- a/apps/website/public/learn/add-it-up-every-clock/index.html +++ b/apps/website/public/learn/add-it-up-every-clock/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Add it up on every clock

You will learn

What on_clock adds to the dot product, and why this spec's tests never reach the register.

stream_ternary_mac.t27 keeps the same dot27 and adds a register, acc, and on_clock, which adds dot27(a, b) to acc. on_clock is clocked: it runs once per clock edge, and acc holds its value between edges. In the generated Verilog, rst_n low clears acc and acc changes only while en is high; the spec itself has no en. The native t27c runs all 4 tests, all pass, none vacuous; the browser skips them for want of assert_eq. All 4 call dot27 and none drives on_clock, so the test-waves widget, not a test, checks the accumulate line. The recording narrows the mask for a on line 26 from 3 to 1, so a P in a reads as N, and exactly one test fails, dot_all_p_x_all_p. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the mask that changes and the test that fails; then in the spec frame find on_clock and check that no test calls it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on stream_ternary_mac.t27 -- Accumulate on the clock, native
t27c on stream_ternary_mac.t27 -- Accumulate on the clock, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 4 tests pass natively; a lane mask that loses a bit fails exactly one test, dot_all_p_x_all_p; git restores the spec.

specs/ternary/stream_ternary_mac.t27

module StreamTernaryMac;
@@ -120,6 +152,7 @@ 

Add it up on every clock

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/address-decode/index.html b/apps/website/public/learn/address-decode/index.html index 9e1ca990a6..08a3793a59 100644 --- a/apps/website/public/learn/address-decode/index.html +++ b/apps/website/public/learn/address-decode/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Address decode

You will learn

How many address bits a peripheral count costs, and what the bench of the bridge checks.

Addressing on APB is a question of bits: how many servants sit behind the bridge decides how many address bits the decode spends. The spec answers by count -- addr_bits_for_1_peripheral, addr_bits_for_4_peripherals, addr_bits_for_8_peripherals -- and its testbench drives the result: test_reset_state, test_apb_write, test_apb_read, test_write_read_roundtrip, test_multiple_apb_writes, eight tests. The recording lowers the APB bridge testbench spec to Verilog.

Try it

In the recording, find the bench tests; then in the spec frame compute the address bits the spec spends for 8 peripherals.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on apb_bridge_tb.t27 -- the testbench as RTL
t27c gen-verilog on apb_bridge_tb.t27 -- the testbench as RTL ↗

The APB bridge testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/apb_bridge_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -226,6 +258,7 @@ 

Address decode

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/aging-a-label/index.html b/apps/website/public/learn/aging-a-label/index.html index 6b685837a1..6ab0f5bca0 100644 --- a/apps/website/public/learn/aging-a-label/index.html +++ b/apps/website/public/learn/aging-a-label/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Aging a label

You will learn

How a labelled issue moves up with age, and why only by one level.

Without labels the Queen takes issues in GitHub's listing order. priority.t27 adds four levels, critical, high, normal and low; lower runs first, and an unlabelled issue counts as normal. A labelled issue gains one level after AGING_DAYS, 14 days, and at most MAX_AGING_STEPS, 1 level, so a low issue reaches normal on day 14 and stays there. High and critical do not age. effective_level computes the line the widget draws.

Try it

Find the day a labelled low issue moves up; then remove the label and drag to day 60.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Aging: how long a labelled low issue waits
Aging: how long a labelled low issue waits ↗

Pick a level, label it or not, and drag its age: a labelled issue gains one level after 14 days, at most one, and never reaches critical.

specs/queen/priority.t27

// SPDX-License-Identifier: Apache-2.0
@@ -231,6 +263,7 @@ 

Aging a label

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/ai-numbers/all/card.png b/apps/website/public/learn/ai-numbers/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..36509f71f5b585c57b1c58bc1b48ae2ff030d25d GIT binary patch literal 38924 zcmeEtWmJ?=+b$M}l!6$fN(l%kDcvpIF@PY=FmwzIsGtZ)cO%TuB{d8wC@mmE3^5Ej zba!(e-m|`cXRY(^Tj#9x@#kS?P3&jydtdhzdqOqU70K?=+#?_$AX8S7(N$dKguTPPg>grt{@0f6YyH8SYDFT+cm$Q721w6xQXB=J= zyW*@>x@eO&yjV6KR4Yi=)F{)?T!D z6S^j&j(Bg~BE=4zjcg&`y4x;Fq`PmPWV&w(XFLSPK=6^>6BrfnmnSE6_xj2z|3BCN zFXmxn^Hv*U;JMZfV6-1=UHXNWUT!=U5569|h4$_L%XPy~h3@*5QgMT_|Gmq8J?#Ej zp%2czbdx&XL6rzAs>|(uZ}qIO%Y*8ap$^tR?FU;=HI4KQ>$upgHnDp0dS&K;sy4Ie zpFc#*1D^45ZFcBQv-drUJ)f&pTe%pKBw1o5%{ov{7}Y2AbGKL-dz$T_wTO>Gj z)O@_g!l!L2ZB2dZ1k+p(-hh8gZA1O0vVpl(wjQZ>k0-vt?(mPsQ!kc)UV9(%Zcy=L z313wzSJ|r5WM=0*LF`J+)*`C%`vPo{9hsPmibYJkHEC3XRaHNPfWTNTzf6{O+E3OT zUo4=(gY#P0_q_$FKTE8e$u)oF=XKI=mC;7YszHlE=DCblae6ZpU%kVObq_g5Zo18d zV=|4+bdTJmvexntY+l7&1I880xnV=xE$(Jp!JHu!E40ol57xcsDmbq4VTT6b3vXhMYETa-h&!zO;io$CKYwd-_Y+e>JJ;vd)~Xkpdp@XIdtN7H32oS z`BSi8)QZ#QVT{+R0CZxC3Hp*qNTTJLpZV08+xC!ixWT~uUbw`>*71+}p}B394Xw4! zHm)@cWZFCzx%U26dE@TxGVW3MI&@<&$d9C|s?ysbLuWjtVUywg;CW*1opP~*jwEQy zZ0$!g*)qBZj8jPD#UI0?jZ3==XlaHpkJlVbh+_2x(Q@?dRm!o!HiJyi3H}Wtg-+vp zdJ+uZKvF$mHFXf(LhkH)dE$BIWHOvlLe*fvW!TvC{^G^Ga9lvGoy9gxTY zbtyUQn7wLeq?$5gT5}fyl}=+Vi(&@+*%Lt?1sxmIxMc^J665 zV`DH^Tat7Wt;f|V>PbwleQB7^g;)okf+$|@y!^@{{U)3r4RG(vz7|y4Vh7OieKX^cEqV#X)Cl7^O z`Zys@?qoJMp%g9FyCblM^r=S0{R)%3gQ?2(gms>%nq7Oz@`2<@R*I^0Vw;6O`w3S$ zel19!@jMu`uy=rxmcF*svL)$AAo~c9e5YP2`NqxclzeqisJ`5KhjYzi-XEdp;S_an zb|@gqeaPWCJ+E`t(cx@V>y%-ZPUo~Tl)L%oXnCr^F~3QKt$N7!RwsNqb~zaee%wuY zeqI^nFP2qX;Kg`9Q>?h|BzUx#GU0LaJ5kwfGm&u)cz-bTUEA6N!XGWr!O@ z5ITC5W{A6cE!L)9+E+dPtG33N%IofBtUkfpXOWxt+G+xue#^G9D}}L0%;gs?DzEBK zu0yq!Z#HYSt<=@5t2m!mlH+k--LL+%XLrOH?Q z?DbS% zg6^!1mR!wQu&H8~T?>Qi50u`~Yb~HLXc|T1vys$0;Yj6!Mjfg0<>2B@5Iwz^9kx%A zTx9EAz8Uen)8I^NTgiHaXs_eVQ&xChIyZPNEj+ z`^?{PwXU8@$0LtQGl=cMdoU=f0ZrMTckr>|6H^CBG6#~h{a$F=0#xDDFv>$1EN?RW zTO8WPQ>Pl$oH!G8=(w4j3Iz|&43-O)bx&xU4RJw_lZXFoa}OFsMoytj*$!%#V@|)h zCme1rc+00v7slxr+Nl0cXb{Aw`-0uIf*8{K#i`I=k93RIs@M>He)$FG4O3fJ;xP2O z%!$RotUd9A41qwz;;&jY#{qx5=p?z^zClZ_3)tp|(C453E`Oh?Dw))>+fLpXC-d_d z`>DieClh=Q!RMvKp&x^BAhXNvqLjG2(u8@kZ>mpeAERB|g_&F(qRkUyGRw>myE%Hm z*V-m_tBO-OvGt}E^$78#B}%yKAYitqLfDk(%ikf21!u9s?u*mYC-6r9qec0ZI2&i} zIOD5XC_5p+jA$f-urX)TjaJGV95+Bg4e1hYhGcg~jw@7?EDDt~C7}Cqe5-yL^#>cJ zug5ycsL{JMJv50Q-vfddsIQM1{3!lGCq1Gx|~lAGQFBe1-b{FsQwOK5z_b* zpWQfOWl_>zD1)w7gx1?!^{W++K4hrb_$!s4vGS0Pf!<~^X}u)MYg5u~z3Vb(9kXuI z>+A&{QIAq@Z8|Fub+_~$?OA`}X?qAZKQi`0!9`mb&^Hhlg}EV)U|6sj4pW8k7^&Yl zTS(oUPPtGRee95?h`~YG7K0av1zuDi>(f`~S=t^tLdLiql5nmtevJ?LWiYN-4vqB- z%cJ)K&kxClBnXw8U~Af2j^m<7j8!0b!gvGzSHnL2SVOU;*&;13&3#RsT1U($kfYE> z5yiveg#;CrGFvG-jeO1d57x62-@o7bkud2+|F+6^X?r%#3G{t35z59us`dMx$&&^z z9SvdwzYc)goL{oh7eSQ8YaBMkGz|^C7JtFLy<4$&h)#*(sYN`iy~xRGz#x>P$#}}; zR2&*(q96C@!To2`%+kq88Ux*xZD8x3?Y9V9IgJzh&NZ6*7MunS_r@%aCm;vWq zajCB5J_bE5uq56bX8EPDk*w>l!!|DIIqk?%V%s3)P;zH&S_ewRIJM+&JTar>SmH-9 z+HvPhIjSspQ-I7%fqsK?s)4-q{O6QW`G<$Mdv~hcq9U2OJ#8b6Iade9S90~&v{)L` z)@?s7h8Bv~L%hLAX&i$2Ui1jyz|_M6t9X>UO754$+}u3#L;cg5j*l z;%Kn$c!s-GocRQ0I;IZ#?H5uA!kTYjL9~xCTy@^l&Ns{%+{Fn?hy70NPWq?tt>VM+ z_}?ehh!pN;Vkp1yh|u12Gcl^bVO@p-4`^|b-FS&8jnlO73+q^sGiZoz!Oyd@veZ2%HH3HZn?XU8;0Ln-Je$>{0^se$QCo+@&1&-MU{%K1 zQ<&eRj>SWZm3*&n47HoZ6&ys4L|?o&hD7UznrTX{T-2KKk02%|QQ)xdnycrzX7?$D z1VI_@l{T2XHia`kkt0S?<*DOec?e;%6}nYZAvs-Wfmg!Dg#OFt_63b-9eciv-*Nek z$A=y32DYZO;MARH+cviqNp8n64i`5A^*k8=%HMRbo3`^e@hq(zf`85FZ{6AiZTPcw zl4i<4>Wtz(@VQ`-;Og+xKtd)3QDs}%7QP%m@3oxlnmdL$;Jq(&rElkkKNNe>(I;MQ zym8vCX2+OIRA78J%CqKY`lpDfB~?v54AZv!HfE>fM~xAR`%;Xw0!1F$j3n__;;#GI z3cuB)q9j&t1+&4~PL^X}Xtv_xZqC+wV!uR!Rl2NK+--}hGU7`?(c^YW=1OgF{>ctu zRiOkw1WEa(E2;-H>7|z`rdeli&^LBF^Z}C$jvbQLZQ0K#;b;F9JRUqt{DWwHsLaFZ zP}zF1$Ta{jhzXdEYj~`t65jPUU0AF-um_IXH3!fERb^}2sPn<)%T3C~N27ni+uF0( zx?rPse76WnH}^x6GUko`%L~YLkgtrB3%mjPEIMKw6-Jfuxq;9_l;pby?|mQ$nj9F6>X6@$u&=ckcr2McwCJVw)gt0!t^nZl=V_@29Ne>iWA>yaGvm$V=seQvaJ?qttHcr; zJR&0QDnUILj5FHjVYaLTw})1?wcTP{%lx3aT&~`V_I029Lw@6Mr%FB0OX`PJQsT%f zPk)5l5H>}%rvKD?Yd|HmH-%pZ6!!XsRJ}`QKSD`y~9gT9hkpirEm+b z__`$g^iMXIOtl9Y`6gWA#It(Nj;Ls|#!vf3OZoddjkW%;QNhxXb@i?3+VjHQu?Gf` zN>7-l%5Z^Lm8B+SNwI-CW`n z(PyM6rw%k?Xm0q3x^#%oHqKcZV~ zuY&6`Gr}jBM_*1?TddU1@=?h+dRcQDI;INiIMiCdOXXJ!4E-I4PkTJ|#&VE8V<1XR zIZe?05FVV#&d0a-h#X^dE6AFS;Fov0gqCZy{>mszi6e4`JKr&Kc({v1#S{bV(woCE zc8Z>vpNEW-&Fne3s@8)Cifa~Ib|&gyTmZ!BLVmnAyfWcq87zlN0Ur5{d{cC8(Us`& za_NhIyuIrD2_6m`SYMZ5ng?E`niFFyOr8(kJB{^sP#SY`cWC;#94U@Fj&2Q`y0%H= z92a<&gL9IH6id${U(SlRK~3ttCYCZJ#Q0u`zMuQ}n%S!dU9)QWxu*;fH+;}ed+{e_ z<%7dLz9zn=g5`0^_Sz1)Kk)Qhadc(|j7+2;{mqPmA=zngX2O_fB6@Zl^IYuT6_0S* zqk@b-*49MWyVL3c2K)WfL*66%*u)r0nwV(H$Mr>EZYqLbU|0C_mA2W;!aY_#WPg-*UMO6Ne0eq#I@91BzBS6? zZ?Uyk%P5>zeak`4PLHYW6R3AmWVs;f?))oJN5=%gd9Qgzsj2zTt*%Hhx~1)U^C$`N zo3(mRm_IVfhcjw5NQ)lOz%Wxxufk9%p4ut>gUAmheNQHJU~Vqj#`Pv^=~*f2d2W;F znuf;V9jcr%nevm!dVSb8^e4N8)&3>6EByFlbAQ(kGVVCcFob@lUua~^{GJQ;ZT4oC zKtcz;yZc2Aqb_U_GEp7B-A^O>G|hjb26K5@=@QcGTIn=20ba%O{ScRxO|c{-@W+Mb zu5viun0ht!If07OJY51N^ZC~d!~0dSeE~&v{)QLM#bVy83uFIqg|O=SNs6Y~cgZ)J zEJLE6^4a*5bm+2W(%Vm^fGa#NC}^_|tQsUIa>#Sm9|Yp1N^AB+JU2%2&08dzXd1ms zHifGQJXMSk2kB+v?%4rkW=Jk~O-KK1fzgZxycE|UtWkg}Y*e5$u-C0Wpv#RHZ}^r5%9s)v?=|LC{(Y2u z@LkkTH^YxSOVHgI3WXY*4t(`J{D6Sni2ip;{J>WK>-wuH*9W!j#1wP|Vk_r(&$P}1 zu|52AfSRviFmx_PDu2ek(|CDnyZaC5M7g;7S?*FSOR`&SOw8D8$ENP zA7=2MXkdiZ z$R)vC6FFshI2Pz1d>NIw*D8&;^DY>Pm==W2_>z}<{p5PZ4r^mG_8yN)Wl|imkkwB9 z9b@d&WU#8t7ui;_YMQGO)jVq!dRHUs?fW%tu!~xd-`I=%395*6&(OQxDsoS-Y+`lv za=`$VFS@0m@v!-D`NCH0{QQw{iVAWY2LfqtNhb|+b|Z_SqmEHfNAgs!?%@CQi8Pdl zcHqJDa+DR@#RZj6XF#T;e=Jz!X(-WDvRSqJKKzcVZ5{&tJ)_oR?$MjeBjUpn!{m-_VzmFtQ_I-Y(dK6(JB#qZwPf z7S~xw1$1+yj+IQ$BM*R2J0CpwRnN2m&4j{*CL^myPZ2dSFyYcjni?+Wav#~gW*(M2 zo$?hjtFQZsjuVbE%WFDBh2~~IkBSu-z80@B?UOhYkqD(f9yI{D=8V>3o^y@R;T%P$ z-@`I6nQvhqrVSk2Vu$_qmOnN11DeaE3^`!gP=)==r<$_$R7T)#m3R%?$W=-j`Cq4P z8+_h=aJ)RtURc3UH(aiZv0;>ZO23Ss<5~66c%jIx;h*8guK63%(w-{~Y7KOsABEl} z@n-)$KYTz;E0HxSe4hBX4Phla(2Ne8$m_9RWh6?Bj5zx(DsleGL~j<2O0iF|e{jP! zj#p5vD6k1|f);Nk6`X(Y?f;DU!p=8;^TqIq*gzRh6J;;m!J712%qU)1)JnU*y6#`_ zK4KD0Uz;f^>h3)+?!)F?tQz?}W3**yEM>)2xQb?dz&mX*kLR0-DA#j-XY}WqxJNI^ zn$5gzj3cbsm{a?nFnD(^)*7kbCiq+8JWK2;W)AAqo%)j-Rtm{S3ACod7{L?tY(JD- z_D7IY-kuk0HTXM>8>4}d-8^Ck&1^auX2ThSW>$;x_&=MNN3XcinPTnYlpf$$6$%tp z#|PgSlNbWM+y;V9jA%hwbGzG08U_z-${Bg_tJ~bLkSYJ8*C7{X<>HFp)&{_591=C< z6Ut+LOZ9|j?$E1RfpHi_HG+KeK@!v?{kLxk*K}R8=Fuc5DI;1=Yr97W!tZz^3LuYb zBvj6!Yl|N6p4QJ1=KLb4Q1I~b-SDK$52CPzaIQ)2D2CDB1F=58LFD#}cC#Je2=#pT z(=G$F;usRbL?28O{$?z1)$|{f#K&Xx(UeJFt73_M=POgIDZdIq?y&(%uq!lDH+HCl zXAW>C>9F2^xV%M~KmT^y@zD5AL1!Os^&W}@DudLZ)9X<^3L6|ONy6JZ+`{3`yKloR zzDF?o3H-%6@{P<$nOd!LekSp6CXs%tU^ega)c9Cl@Jel!xI@C1lp$^H>ZQHH2{BP? zA81Ejgc`qPS_59WdA7P2XA116#FjvB zl{V&1m=^g%n|}JV*N0p3x4jAeaVwqMZXtyEr1tj*!>BxY=t}Lqnl?S!Ypn-({IAA>I(9gY!A3>8!41o2`1l?yj*unmtvPQ>QzB!O1kg!BZn+q!CqZGo9By(2{sH zGB{C{1~IL*7+2iv+hc!#R}>xL#4rT}tFpcCyNpT{zY3dge#us1-i74B4WH(NUaSc{ zvi?9FpS3|IW}Ml=%49W_{E7aAHnh7Kjh7dA*jfH0_eVlU)|| zZ^?7jA@JjNf#=pNA=e#%n+@Y8EL5|c)tMqR7{{A;PYf#W(bqdg1?W{M^p7NMSl-Ne ziS^RS^Y z-3(JzRTY>Pah;R1u*m-GwR|`UX*t_$`2G90MyA-w0mgjVdm4s9p~4I{rW%fN!nx7@ zj>837W>=_3)YQ}?`5KJEpvPuDv#6y^6C)$vg|3(&A_^O8Yj%1}f`OTDp8!TqQSoSV z%B1IpG6(PuYisMRrX!r>)rp3%{~bHf%E}5)^Ks6i39XQG<6Ic$LwM5LCf3Mp^YY?M$Z6~u$_G;hy7y7vHs|9uMd0!8SQb_OX%X0I^)T1r#$>)v zPF|kEJ>EW~bHhe$d-!8c0xX~3;kqJ&@1INWByJFQ^RZ>&+_YOSS4v9CJ-R=TI2q^v z@&Yp3_wU~`M7`^qMLm}PMM+*7?!>02rw`^Ta+c0r zU9?4`p5Is%*tDDN39y#Hl86!`6RxHeVc?-1)ebBIdgb@}8o8 z{CH^}3Q6nbZdm_B#Ncx@<&F2!)YQx-u#;cn$b0j??RFDV#B-GyAAd8OONr@JmO^}C zKc}VTs_hHOfaH~bU)28A^pzt0bl_FfTpXMgjvQFSltcFC4M3iH0RaK;-~aGHtjY)F zC`K{t%9{J{w3F~OW_#R?iHXSyyhQCk5tR>8XMUT`YaJHcO3B4Z;NK10G|~;<11wg% z0F8$muwqV=wHu*qnVK`V^h=Eq-jlI)AbZEY#^SaZqnk2?+RSWhv`!ZHxo_HOq4A!Z zC>m=mV1Xe`2l{uyUQC&9wOj?r$b3FyM9oKvs;H_`QBfrvmYBB$WCfhs=O%PPpFe-D zA$|~l^H-A7MD67NCz#~@#P0FG<4Mt^;}MeV*e)qwOM?N1d@-7y79cp7#DT2a%RD8=_Cd2dXNTx_&l98PNGDzFpy zcQpF$eISdcunR^EaGHVncSo>lRM;qYHN zvcsfb{0M75l!t1$_;ibindU>7%&&Z`-&WHm#MH!ub8seAz!4a5@539jTuAI(zs;vl zpTv~!RyVU{`p8tVRlwmN#w)GEjFcZ9t(jjL?+~(&-@JMAA;fP5kre-kFW}rKynSx5 zgObb)m_)gtj~XizHI5DrMQOCE{BMCxpCg^E=5cP#R`0pybuePkfZ74(#FDdfpkXFpY0E6P$LhP2W6X0_ewv1{>;;Iu5JIOBkHEjhYyX%bK#Ukkx$;p zh)@m<4YeH4k=*&n6El(2($a!!FsXI&o%uw>ykrJlK^y_)UR>VXBO)thvT}T5b^|$G zhBVGD4h{~M4kFb0Nnkt6xp`BgytZKn))NZ&2~`H8e~f zG6Cvz^ml$*g zr6+igU>d08+@nN(Hs#!?rtYm66Y4YB&C^UY<=~^=C;2 z{!M;^PGV7OXN@AJNJ>gtgC$sP6{nGY zH2}nZJwkC$+rtT+9t!>sPzK?)@2#{=wFI`HV@VmF@qhEX zaZDa$+38RNe1!rLBkyUaNERA z9J+s(lr&xkmMu)g>?%J4-c2TI(HXlgHD=zja$2AvM76O z;XtXz*1bR_!cJH6D-G_Ys;C#H8=@Y$=|?e$a}XPH@1Gv5CDby-m}zUH9m|^peYP#; zM_fr+tq<%3Bt?V1z)jxAFH%UJKSRB=Df zY!Gus7e>WlUmux<72hZXX(z>h67}AUpTqwNrDA|}17(-%leVti5^%vxae2NZnPh^) zm9m4hp6{iEvO3`@>n{nys*kS`7 z;g0O=XWcj5W-s@$u9V*6b(;Q^>a?A`+FH`f+PyfMc2uw44!k-F)X94nQ<7seYlw8t z5Z$v>X3RC)I{_o7YJGMr+sR^g;jf1LRaF?-=>skRM8fj~qE?HFO}+Iv-taVTe_nj` zHnxQ9kxN`!+)xjMLgIMFDoQ*LwX-@>yym9{z`y~aqjFR$wSlSYfcTM8`R6suIqlb_ zhCk=J*|Oqe2QR~%_Ld~Ce6e+|+8d+if+s(Oru}vHkl!^X0A#-Sb&J9@-~?Yb#G!9s zP;OME(CoW5S{gQ4@3GDeu$3q)Qu-yz%kLO1oP#EYdPFyRA#~3(+=h!Nga<;%1n| zb2?*70)CSTE%)_2OOOwmH7O$`qhXGqPlYH;#5xrliO0Hmo*(ZdnL+L4<-eF#+GhH8 z^u3+M`E9{g3-jY`>Ne}wM$16OJ_6d4)&r{5EJv>9?$`ap?F5UR97Qoc-TG?k z!9HgirS(%Sg0lhODbLyUUDKE;P`6`g1QaE^N0L6A0}Z$bw>n};Tk6>*uB%?TmJGK4 zo=983EY>vfrTQU%)rekz0pxb@A7KE$5}nG%*L;8}IKufs@I47eMn;5DwES0N2-X>r z!v1c6sfxPJ{Q(+*-c2oxHzLANg^fLeg>5N{mj-vKE=etTGVi2pnA#N5 zU8<29Vh(h#|4kSj^9GZXla~M%7DOQtt?(G3r(}?ZGeJkQN`Kb9YuYQ_KI*{ozSPO0 zTp5V7bS@J`>TQGz#zc`pnN7O zA9t2>qf~zJ2rwWv_(i%@CZzXqymrsg%=mnqi8kIXf)J6S{NjG$R1cn<>6zXfO9=iklddF^j8m*5&-pK9BElmX`jM&e>-Y zHEhZ9tGBl|F2}5YuhP1g`9uBTgrk57GfS_kXrxn#@a?>A_=m|#>u^)^K08e%J;PNm zH3(4ce zq$Jf_iCEr;8eKJUub#2|Sfpx<#WB;x(*3CB?uMd2@jR8Ad(-r$0KK)}FnyuUo6R3o zk3uI?2}Mm2>0~&ugYQw6*(n5tmHyVbsU;jj$fxB8vb4;3SgWm=&=7k)hS=)ha7ugC zxSzMJREqbU|5Gy`H6dEk_PE;VgN?rKGUg>!*?9CQGsy~>uP5^ePpFGA8!P{l%jXxw zQ0gzxCch(GwS8Q5&EFKh&I~E}A_2E_*mAux+ew-xQeEfm& zDIXKzHZ_lj)-HCSjaNi}XOiWNLNCsalFkx$-0p&vc9W{#tu;CRgKem+D#Ruq;6~Or zVlFxDpSnV|C=anHcPlF^>ggF9v#PkS)WmiO;^~Ywm7f{>-Dj~0@F-pPTS2=z#uqfD zwn|`))jw|Z2+r)m7$3J}?Vz2xSZD1vT7IG7xXlObdGY##?>80EKbd}h!g(|UURvyG z&9DRZ`wpCDZzhPM2jf73 z4dn!n|qf$ZY%%>W7Di57saZ=DVs~@)K!r#o-~=?~B{e>jfG6_?nkj8}e}+ zV8ZKtlbi-+=d&S<{Kz*xJ{?5etv%9D4LtmV`R9FgIe?GQ$T>>1b4yJ0LG_us_X(tK z^=v4vn*9!;Fc4#oLFpzTn#^}7?Zs*-Zu+0#lcvnIsxq-`a0=AmBOUukBmSUG7j;k! zAe(=*HW`&A`TyCWCN@796^@Q%MKr~z+t}A6bZPF0qaSgesBVFxEFpzYR%+hB0JT_V z6~>&h(w?Kut!z?I^vl2lF5pFr@ zgJk+`3M0g~GtOdeQ=%(4F$Q}e_Fvass_D}|LU>7{1liFfKdpduPy8bgY&b@D2+tty zIQpvTlI0eqVmG~M4o|yZqvyKWJ5TiQ^EMJ5{@L^DmxZ^Kq?}#&(9AJjP-wmBPNJQ= zD?W|Ie{!|r#_Tn6HhoP$RrD*>cf7#D)Uoy}JM3t|tE855`IT=9-=92Jd#lnL&5^w( zZYc9?MSPUDYw#uUCwOV=5L$DnVzjp>Po_E#~LeNM;rt8GInwpuEh;smX{;3TObXe&39Y_z(-A+{ZVs*O|#Tt;Krsk zCXq5&P^5o;$UiBVnT}K6h-%_1dv&TbkA7P5PNT^G@&dl2z-pCjrIP)=tHXt6P7n9k zxx6J~&mwK68_q2i6cpmJ(!#>Rc1L-+BDq*gE!xAVp}DHq=i+66w_yf|qK6PWyp?xO z$|`)wu>L9a^xi*N3Y2hUHz2`E{~-rsRD5_=lW+XsM_~Q;`cfemM=e*LbnFhAEZ6%q z!K+;YtPnC>t#}jr{32NWXLS67SQ)H;n`RXMiulF;kjkF_)x{B7%gUTlJ}fg&?=GCe ze|Mofm5)Mr0_C1RWa)j7Uat%|0HsgdCZr%At@ZR0u%!uy%8^>-TrFzYz^jW6ithrc z1a!)b@vQ{LeFd6BpgRe?5oMzllfD-gfVFxg$Xs?bM*&J@FOVFq1evK}5D0L3pu zEz&4ULUSV#$IgpgM4dM{0J1wWSyEE+P6a6+{s@o9k7$_Nuu+??{4=TdD4Zi~+Wx!K z`W!_pa4MJMQ7THP3XMYbrZ}~z4)lTzAr-D`XMn52@4aanM8-`06fz?hTZTLD280|v6Qi=1*ZI=- zr+hN9vI0mk*SX;8e&CTpY%%r}-(TaqXCtr3x8&vapE)#IEq$PY?i~ATQI`+}iqa`c z1C;te;H7)}k<$IL$9XE&%CXC;JWbWm0|)z{veHsde*;`>s-Y@RO0LHrN}P$vqDXM8 z-agKaCRR&J>nGr7^et}B%vjhPxVxX0CtB4QS5;L>o-XHZPBoZcI~Gv~s@dpT0NZ!F z*#P_I5}<5c?}J49&;YU=ZYX|#^1ks`sxA-wK*@Cyu(xWRr%nNzKxqg5IBq!Zw$4@X z2)#G<2XY+nGWY^7&rbuJZL2KX@AW-0wO5NaIm?ZbD5}fP&X#f*(T2pCG|0i#Z|QQ^ z&D?CFP)~l{>Z(N~tmVG=S6NBvZNPaQv&B)?kl$XPkN_tcI-RxQgNA{dxzoPu9eZKG zBTR>}iV%k$C`7KPt-x(Ziu59hr7H7re>DJO0y_KUF`aqLhrGHU_4UTw1=z%eW|pUF zkS_$H_JQ{MBzWexg6f@r{w()F*o}VKbC3%yeT?Bh#JUeWC7l!ZT2JP`=Tkiz*Ge_) z#)R<)X=kr*f4p&ve_9~9qZS9)i)%?#6={OtR9pvOSoOFni?)a+AJ z4lP)fV?+we27S4iKVJay1>Z4MZZ0`a)g&mvR!OUFpt)%TrI-MZSGE`G#xM%Jq=F~n zk8g)n^8mf~g7Spu&K>;1f)dn=ZPj@ZR0CG^VZ_|HCBrUzU?Yu1LZ*SK zY47GZ`LUv+LNn~+>B$^m7_NN(P8#&7H+CH-*v-5W*C5SO7mwb0N|H$pg$HG)2Da-o*Flp?j* zNNH-A;XaKRVo^!GM*P`uZzyF6RD}A+5I;3QlrSWBS#<4W-0O5J;9RHxG7(~7W@#ER ze#?KhCK^Qokyr81P+aL6PzMfe5~}lGn4RXqaD}w3pZ0e(IQLgDY z@LbV~-*iO0p#{^Kr-*nKnW^ppLV0xIy?lqS8b{#aK^?!IzJAYpZj;)QOKN*xqskAV zX3VeP_4DeU(ojG6Q+WsZ!@wTvk>c@5Wovnr(o-KPx6Y~o3CH^~e%3`E!jMQEBJqP^ z9k=fN4jrXNu6+3_NtEYt*F~2=pAx~|ZZ8k*Uz_LD`hHSAOBvp)WRDWe$T8IB)RVDo z+L88xbgG|S*`8fvFC5nT2AiPLXfx_{ZL^6aSW$jky%UVChZ|)o`B>0BE;T`_-yXcD*@vRt@n{jB_RN__1moTGEQcrGf zZm;^!=!eBg`Yd`tzBP1xo0x9(9m+&amoeOamnTVH+Fa&#hBUsPR+ z58Mc|()AFi6>+oOidRllvc?=n|+Foo6+L8%f~p{23DF+oJBldb;05! z@*{_91%#qaoPYz&b$~ofO4nyjqWvMQmz|>Vj6ci6k;k;|pGDC1@69;k-5!Rqk)~E7 znv5z@xQ4@SCl*atf2|^YjG15Q93M@eBcWrMl59}*_qU_ee*o?NBD3HZZTn__Lu zM&%MT)p2cCX^`f@Ni*(Z9kFM6j7?vr{x;7areXHRxjmYJ01*K!d_irkzKCB2 z`n#O9c1=N)t?5V<>98r`sQPXy?n0?NoK-}`*fl7aUp*s>L0+zpjjc1gQ)7-3g%{2g zR}OLO^frCnk&wo8p60t=nz;JC(@NDH4HSeKBN<0+rb*~e@l=D7Zc@rx-D>9ZxU&-e z2P#UCD86eCk9ZaPoiMGuROQ&~$1TEOLQdDF)79cK9+f``q2~>zi-M-nnyc<*qJUcY zDd^-bu$^^v-gzKz4@OU#K^?^>aM@a&_CouMQ?WfiaeDzhDQ{8;nfMT)%Sj^p69e#L zuY86@^xYXS$?eo0IFirP*JB9#rh^LXXRo$uc6-d>fYe%aBlANlk0 zCZ857v}BE3=~{Wx zZ3|6FJ6Ob`K$CSjwFyIf&!@FDfW-!qC3;0WerRk?&#>{WbHs2rZ3r;AH~Ic}Xu=bQ z76YtAbol0ePW6K^jLWWogqvjSX_HOs3wwo$t$hiW$Gr>>o?;~e3N^|V`}=OlmC{|J zc$3T503Dq*#Fu!G>A%|z$ir3GznT8cf|O32Lt+23_eybCz_Kep8QotQ0x3@TO#u$8 zk*20a#i#00)y7kx<0*?Z!p^*i+Ya*1?TEp8ZAcP&u4nNKq(P2MY7ZnG-q?ws0z)sa zj-jE&U`%FzOtQK_CC1cKH}`8X-}{P+ixU>#y!?l_hd`d!yX6Is(7hg~gXV70p>(Vg z!@ex8N0u?ajSs8y2;nws92-Kdzz3wOu8ev#3zr=uA17=Gs0McH#8L@N!ddkET$`LA zgLLt0V_mDFXf*meRZzVB5!PLUY7{u_^p$phViCdm6W|kwH)x{_z#yU@-d%$ z)1jJkez;JFFqgnMM0%UGbe7O)Y{sc!hhCIKCa#l!jSfgleGLP}e`&#sMa5<4zjv=0ugx2dNprwcPBmw_z!4rP zJ&Ci^6qzGEC1jyV2Y`QZuPlPs?g|PB3v6TO8Si`}YXmzXpDHcsj2OUJT9q!ZX}~9T z*x3dW3Q=}0Dk&NEGeEynQu>y55$z1rw4;ZmZICp7X~zt=)An+(rBCe?s_LxmXG5VQ zrVI)ZK;2uA2l(ulYOeZe&*!iSbnw(YPJ5j;+BMA^KTOwM=R4SOqi*5kt!t$BRN7xp zPq;ViT;vgxe$Dh#nczXJZS{+8c?60?g!44}9ITEolr|R$IqU-wQto11q<~;qdC1qV ztK#Mhmw)nIUf|Q@f(ZAvl)pfF;@KHWMGQ4)2FX(GCtb7_^{q@5h3t$IBOeFFc4lXW zMfUmNpEn&aKQw7?>QUHX2pX604{Igs_i_5s8W*BY!dv4_*c$4(Jo)!d;#5*xTwHYY zv#A-h)Jp#$;KxG`$88Z`bE}zEe5~j>p2c^Svgnha_dx>Y&qz2$3rkA{xpS;-dCDy8E7C{24iE7Hyhp;p>}nTPd0j20-Qj7t5+1H0w*qS>tomk6R?QT;wdPlPM=QT>VMtJ_!Zc+ZXOr zDagwMF?QhDH3gcwOm_!lEMWaUQXqz8%iam*+HcIdozfBa?Ccq_JSoG53rH7Z!G3r+ zay(dW-a^FaueryyBKXGVbKB*I&#imJuCA_2J}+Otu3*Xh5z8@n-Ea#*sU>ss^9ajp z;G_MsK{ym#7t75$Z(m72!o$7AFP-zLu~BSG&@U}mF34?=OyQZTO4{r9pNB~88QvH+ zp8$QqtLg>!MI595b}OJL;1M%`-%ZbN7mY4^qDzNAS4u;!t;LcZuvTh2MX=JBc;^t4 zGV}q+IHarR_WPopC*TJXc2+d5k^WZ8o!V5H4|>GjE_l?`6g^zr$ne%hswjWSr_0Ad zW%_+Zb^%=tPDT{qbbLyJ;7bd*w|&2v6`OdlhS*Ncj*hORn%jON8OS+Vl1$OL ziW#f=*ko&)bR&?Y1^ zP10^_;kcHwNSY92be$AA37CqOP@n@rne^d&F1SYD$a1BGL5o+2rnQo$=t~XM!CQfs z*YO&_Mt-)=G@YhMnkK2$u8mjax6&kpfrHbqQSpb$_sD{r=}=L*tcfbEq5jYF6=+F`deqA&)v8>+m(mH*(%Y>Wt9Ehbv0F`Qf zv1;J9!F<=l;WE0-px&Baa`}=n(kqq$o3h{T>UsiX$n|{VGe8(Pqi%OYF?O37Mx*hB zGa~*vjb@8@qx9=K8U{@7JKjr~N9$Ds^@80eXJ@Lwsplgf9w=a*@9)M~(z@3GoofXQ z93>HArU(E~$xWZ^l;xpGaib-aO+Ed!om>mx`RwiP+VrQN03oa^fT4iVmxW72lQr88 zFd#rNUny5Ok^(}3q-zhKWS+>+w3FE?f(iQ_|23B8Ad@8eqh@)AalIiTIpIu;^Dlak za)E=#sPd1+EmWE+PY(QPw<#rE4+?fX8$zbA56Com^#=5(u36QgidMqdd^q9D)`1-P z@XLepK;`^&936y9y3JE~3C;O(q!&1Ia-L}7?CO-Aw6<0~mYcg+p6u`)SROV+Zrycn z#>K`C_T9LJj?KpivQx7*-Er}c^JstaikNHTh|lJ)CJj@~x!1(y13J1_7aY#c>va}u z*C$et>8C&o1_E`K)i}}9{tQvXBV3ImX05DY6G&H*6wJq^jA!7_O*e-k)E5`oR}M=U zEt$!3kP}M(I2)eNI(vE^07lUMO-T(RBV}(LFRw!Y?o8(UfS60X^L?{yl zbUGYo8v&d#DC&yfe(~5QmtUdWja{G%2sl<@JsBu4f-qa?ch#R@ZA{Bf2W`TkRI2dh z$v~iry3iOaR>3uB|9j0zk+XzM|8F2~J;2cepTH_4guy)GbshR5xakC>OGYit;UC7V zdlT*R6ju783%0yl&N8ZdfWuD8D#e9`q2InmhednzjwQW_7o-8$2>-2@gYV(t*It$B%}`PVLv!F& zKw;WbU5rUR(e*YVBEEY~g_=+a>X~A`lVBuD_(qv-;eqiKT!v`_ys_-e40b}>KTFZE zC$yhg+2*|Mf48E!tIJ4a9ig}X>+mICf;5pa{vKi<@-pHLL)mmB^ltl* zh9p;L%L&L%?R)u;NP+akcbMp!Q zQ!;Hv9pfh~jhW=UABMA6v?d--nUl9?bD5rgCN&oDkG{=(odLSHQQDtJvnn8D;}#7u z*76+@w3u`@J$Tl?a4W?upSe&Qi7y90y!?_Ow!m;AjZ84wJL6G7v<1-9tq2)o&_h04 zHg97R13F^_xjHRGxC_;v{=K0&-~+ul6i}_&FHj}6NWYwV{yZA@f}2&>*m&Y^L+J2F z6I-JVLFRF_`XPFAb{?Lj;R58aPcAcS{1C30P-t9y``0ai(`BN?h{)-#GucK7i_XV% z!fqb`C)b&K^`8hc`T6#53bIEKyWt-H5wSVHX{48dM z=eeKzdSCDB^}gq=l`sdo2xt9aWoGXC@HGw#pN?TCh%B_-4-(bw{t_79p9q`phcB2; zPVMb4wV_+Z78p+m1Oh=$mZUD@00_tF)2A}Hx@w|h>lb3gi`ZBKUmRY$sefZoPvjWm zN*O*-xjL5#&su3(+uDHrmv&Yxv?5733u(vPtHW2lAixsNmXC)g^~Odwh6x}3xc3k| z>K}asP3Z9$-77s6J&w`9z*FVO7a{_ubU9Mi2@R*u_(OeIRbT5b#`0}lsShU&ufXKzr2 zHL=-@%*>a7NML+tfd9Az)Lw_<%@GB?uqijxIdp5Hw#iD^mtjTHYZPepd@b)3Q7;$* zo)tt2{7zj})%3IC;~j>b0pK>Nsi`HFK1)&;rvxCy!AckN$5-<_PI8Bpy$qAfz04(c zM$FG(HbW^Qsx8Cy8^!vys*uC%`G_oq4d69dg*BSNDMUQa_qB|?s<4ENl$Ae%ArYUk zi~OY%@b!nljL(&=cy$*TB-ur&sD7>?{*X8amFWFq^v!>>AdCE+5?b}f>iHhnLNk

r#vU+W>ws(xp=1sJp}3pj)G=?= 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 E0P*9Z_y7O^ literal 0 HcmV?d00001 diff --git a/apps/website/public/learn/ai-numbers/all/index.html b/apps/website/public/learn/ai-numbers/all/index.html new file mode 100644 index 0000000000..376d9ecf62 --- /dev/null +++ b/apps/website/public/learn/ai-numbers/all/index.html @@ -0,0 +1,482 @@ + + + + + + +AI numbers with t27: from number formats to a ternary network: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

t27.ai
+
+ +
+
+

Course · Whole course on one page

+

AI numbers with t27: from number formats to a ternary network

+

It picks up where the FPGA course ends. Every lesson opens a real tool or a recording of t27c and Zig on a real machine, next to a spec you can run in your browser.

+

Course 2, 27 lessons, one widget and one t27 spec each: a number format of our own, the OCP MX block formats AI chips use, ternary weights and the Ternary Network Float, then signed arithmetic, the parts of a neuron, a training step, BitNet ternary neurons and the ternary MAC as logic. Every new lesson plants one bug and shows the test that catches it.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · Lab: our own research

A number format of our own, an honest scoreboard, and a model's tables multiplied on the board.

+
+
01

Lesson 1 of 27

T27: a number format of our own

+
+

You will learnHow three trits give more levels than a 4-bit float, and what that costs in plain bits.

A 4-bit float such as E2M1, the element of NVFP4 and MXFP4, has 16 codes, and two of them are zero. Three balanced trits have 3 x 3 x 3 = 27 states. T27 is our format that uses all of them: 27 levels placed where a trained network's weights actually fall, and one shared scale per block of weights. On ternary storage that is more levels in the same room. Packed into plain binary bits it is larger, not smaller, and the widget shows both counts.

Try it

Move the weight across the range and find where E2M1 rounds worse than T27; then read the storage table in bits. In the spec frame, tnf8 spends three trits on a float exponent: find the test that counts its values, and the offset it reserves.

+
T27 cell: 27 seats in 3 trits against FP4's 16 codes in 4 bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/tnf8.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

An honest scoreboard

+
+

You will learnHow T27 was compared with NVFP4, MX+ and MXFP4 on a real language model, and what the result does not show.

A format is judged by what it does to a model. We stored the weights of one small language model in each format and measured perplexity on text it had not seen: lower is better. The rule was written before the run: T27 beats a rival when its perplexity is below 990 thousandths of the rival's. It beat NVFP4, MX+ and MXFP4, and it lost to E2M2, a wider format. The panel under the bars lists what this test cannot claim. The one claim that holds: T27 beats NVFP4 on a ternary substrate.

Try it

Find the NVFP4 ratio and the threshold line; then name the format T27 loses to and what it pays for that. The spec frame is a control for another claim: find what its header says a posit match would falsify, and the test that holds es at 2 for every width.

+
T27 vs NVFP4: six weight formats on one small language modelThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/posit_ladder_control.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

A model's tables on the board

+
+

You will learnHow the host feeds the board over a serial bridge, why the window size matters, and what the board computed.

The board does the arithmetic; the host sends it work over a USB serial bridge. The board's answers wait in the bridge chip's small receive buffer, and when the host keeps more requests in flight than their answers fit, answers are lost. A smaller window removed the loss and did not slow the run. Over that link the board multiplied every ternary weight matrix of a small language model, and every row matched the reference bit for bit. The text itself is generated on the Mac, which does everything except the ternary dot products: the board is the calculator, not the whole model.

Try it

Drag the window until the bucket overflows and note the largest window that fits; then compare the two real runs. In the spec frame, weighted applies a weight by its sign alone; find apply_alpha, where each layer multiplies once, and the test that shows it rounds down.

+
The bucket under the tap: a 512-byte UART buffer and 19-byte answersThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/igla/race/unit_weights_node.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · AI numbers: the MX block

How AI chips keep weights in a few bits: one shared scale per block, the scale byte itself, and what one outlier does to its neighbours.

+
+
04

Lesson 4 of 27

One scale for a block of weights

+
+

You will learnWhy AI formats share one scale across a block of weights, and how the scale byte of OCP MX is read.

A language model has millions of weights, and a full float for each is expensive to store and to move. The Microscaling (MX) formats of the Open Compute Project keep each weight in 4, 6 or 8 bits and give every block of 32 weights one shared scale. That scale is a single byte called E8M0: no sign and no mantissa, only an exponent, so code e means 2 to the power e minus 127, and code 255 means NaN. The player compiles e8m0.t27, the spec of that byte, in your browser and runs its tests. Where the browser cannot run a check, it skips it and says why.

Try it

Run the tests and count the skips; then open the Verilog and find the function that checks for code 255. In the spec frame, the catalog gives FP4 E2M1 and MXFP4 the same bits: compare their storage fields and find what MXFP4 adds.

+
e8m0.t27, the OCP MX scale byte, compiled inside the postThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/formats_catalog.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

The scale byte on a real machine

+
+

You will learnWhat the native compiler checks in the same spec, including what the browser skipped.

The player in the last lesson could not run every check in e8m0.t27, and it said so. This recording runs the native t27c and Zig on a real machine on the same spec: its constants, the test report, the Zig tests, and the Verilog for the NaN check. Some checks are invariants the compiler proves while it compiles, so compiling is the check. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find how many invariants the test report proved at compile time, and compare its pass count with the player's.

+
t27c on e8m0.t27 -- the MX shared scale byte, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/e8m0.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

One outlier, many zeros

+
+

You will learnWhat a shared scale costs: how one large weight pushes the small weights of its block to zero, format by format.

A shared scale is set by the largest value in its block, so one outlier sets it for all 32 weights. Weights much smaller than the outlier then fall below the smallest step the element can show and are stored as zero. This recording runs ocp_mx.t27, our spec of OCP MX v1.0, natively on a block of 31 small weights and one outlier, and counts how many each element format flushes to zero. Then it plants a bug, one changed exponent bias, and exactly one test fails: a spec that carries its tests catches its own mistakes.

Try it

Read which element format flushes the most small weights to zero and which two flush none; then find the test the planted bug breaks. A 4-bit element has a narrow range: in the spec frame, find max_value and min_positive of GF4 and the two tests that pin them.

+
t27c on ocp_mx.t27 -- OCP MX v1.0, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf4.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · Ternary weights

Weights that are only minus, zero or plus a scale, the five rules a ternary alphabet must pass, and a test pass that checked nothing.

+
+
07

Lesson 7 of 27

Weights of minus phi, zero and plus phi

+
+

You will learnHow a ternary weight is stored in 2 bits, what the fourth code is for, and what the spec does not claim about phi.

Ternary networks such as BitNet keep each weight as minus one, zero or plus one times a scale, so a multiply becomes an add, a subtract or nothing. gfternary.t27 fixes that scale at phi, about 1.618, and stores the three values in 2 bits: 00 is zero, 01 is plus phi, 10 is minus phi. Two bits have a fourth code, 11, and the spec folds it to zero instead of leaving it undefined. The spec also says what it does not claim: that a phi scale beats plain integer ternary weights is an open conjecture, and it names the measured gap that would falsify it. The player compiles it in your browser; most checks it cannot run here, and each skip says why.

Try it

Run the tests and read why the skips were skipped; then find the code that folds to zero and the line that folds it. The golden ratio can also size a format: in the spec frame, find golden_section and read how gft4 splits 4 positions between sign, trits and mantissa.

+
gfternary.t27, phi-scaled ternary weights, compiled inside the postThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gft4.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

A pass that checked nothing

+
+

You will learnWhat a vacuous pass is, why a green report can hide one, and how a planted bug tells real checks from empty ones.

The native t27c runs all 13 tests of gfternary.t27, and all 13 pass. The same report prints a line most tools never do: 8 of the 13 passed with no runtime assert executed. A vacuous pass is not a lie, but it is not evidence either. The 5 invariants are proved while the spec compiles, and one of them asserts only true, a placeholder. So the recording plants a bug: the reserved code 11 is no longer folded to zero. Exactly one test fails, the one written for that rule. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find the vacuous-pass line and the test the planted bug breaks; then open the spec and find the invariant that asserts only true.

+
t27c on gfternary.t27 -- phi-scaled ternary weights, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gfternary.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Five rules for a weight alphabet

+
+

You will learnWhat values a ternary weight may take, how five measured rules leave one formula, and what a sixth rule removes from it.

The spec golden_sieve.t27 gives a ternary weight five measured rules and a sixth that narrows what they leave. S1: the number of values is a power of three; S2: at most two trits, as a third gave no significant gain. S3: one accumulator lane, so any two weights have a rational ratio: plus and minus phi pass as a common scale, while 1 and phi need two lanes. S4: at most six input bits per neuron, a trade, not a law, says the spec; S5: no DSP48E1 or SRL16E cells, for which openXC7 wrote a wrong bitstream while every tool said OK. The five leave TNF(k, b) with 3 or 9 levels, and S6 removes the 9-level form: on every integer ladder the top weight outweighs the others added, so one input decides. The browser runs all 3 tests and all 8 invariants.

Try it

Run the tests; then change MAX_TRITS to 3 in the source and see which two checks fail. In the spec frame, trits size a float exponent, not a weight: find exp_values of tnf4 and the test that says which offset is not finite.

+
golden_sieve.t27, the ternary sieve, compiled inside the postThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/tnf4.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · The Ternary Network Float

A rule the compiler enforces before any test runs, and a 17-bit float whose exponent is four balanced trits.

+
+
10

Lesson 10 of 27

Blocked is not failed

+
+

You will learnWhy a rule checked while compiling stops a spec before any test runs, and how that differs from a failing test.

In the browser, setting MAX_TRITS to 3 made two checks fail. The native t27c is stricter: the 8 invariants of golden_sieve.t27 are proved while it compiles, so with a third trit the spec does not compile at all. The report says BLOCKED, and explains that a blocked spec never produced a binary, so it has no test results to count. A rule checked while compiling cannot ship broken. Then the recording plants a different bug: the rule against shift-register cells now always says yes, and exactly one test fails, the one that checks the formula. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find the line that says why a blocked spec has no test results, and the test the second bug breaks.

+
t27c on golden_sieve.t27 -- the ternary sieve, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/golden_sieve.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

A float whose exponent is four trits

+
+

You will learnHow TNF17e packs a sign, a ternary exponent and a mantissa into 17 bits, and why 17 and not 16.

The name TNF covers two different things. In the sieve, TNF(k, b) is an alphabet of weights with 3 or 9 levels. TNF17e in tnf17.t27 is a Ternary Network Float, which the spec calls the signed accumulator format: a sign bit, a 7-bit offset and a 9-bit mantissa, worth (-1)^s x (1 + m/512) x 2^(offset - 40). Its trits are in the exponent, not in the weights: the offset takes 81 values, exactly 3^4, so the exponent is four balanced trits, from -40 to +40. Four trits cost 7 bits on a binary chip, so the rung is 17 bits, not 16; the spec records that its source counted positions, and a trit is not a bit. The browser runs 20 of its 44 checks, all 10 invariants among them, and names the cast behind each skip.

Try it

Read the reason on one skipped test; then find the invariant that says four trits span 81 values. In the spec frame, tnf16 has four exponent trits too and sums to 16: find width_rule and read whether that 16 counts bits or positions.

+
tnf17.t27, a 17-bit ternary-exponent float, compiled inside the postThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/tnf16.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

Negate twice, get the number back

+
+

You will learnHow a test of a property catches a one-character bug that a single example misses.

The browser skipped 24 checks of tnf17.t27; the native t27c runs all 34 tests, all pass, and none is vacuous. Negation flips the sign bit with XOR. The recording swaps XOR for OR, a one-character bug. Negating a positive number still looks right, so the test that negates one still passes. But negating a negative number now leaves it negative, so negating twice no longer gives the number back. Exactly one test fails, negate_is_an_involution, the one that states that property. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find how many passes were vacuous; then go back to the player of the previous lesson, change the XOR to OR yourself, and see whether the browser catches it too.

+
t27c on tnf17.t27 -- a 17-bit ternary-exponent float, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/tnf17.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · Arithmetic on signed numbers

Multiply two signed numbers, add them when their signs differ, and do both at once in a multiply-accumulate.

+
+
13

Lesson 13 of 27

A sign is one bit

+
+

You will learnHow a signed multiply sets the sign of its product, and which test notices when it never does.

Modules 1 to 4 were about storing numbers: the T27 cell, the OCP MX scale byte, ternary weights scaled by phi, and TNF; this module makes them do arithmetic. gft_smul.t27 uses the bits of tnf17.t27: 1.0 is 20480, and -1.0 is 86016, the same bits plus the sign bit 65536. smul sets the sign when the two input signs differ and leaves the size to magmul. The browser skips all 3 tests because its runner does not know assert_eq yet; the native t27c runs all 3, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that makes the sign always 0, and t27c test-report again: exactly one test fails, m2, which multiplies 1.0 by -1.0. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find m1 and m3 and work out why a sign that is always 0 cannot break them.

+
t27c on gft_smul.t27 -- a sign is one bit, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_smul.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Opposite signs subtract

+
+

You will learnHow a signed add turns into a subtraction when the signs differ, and what its 3 tests leave unchecked.

sadd in gft_sadd.t27 adds two numbers of the same sign with magadd. When the signs differ it subtracts the smaller size from the larger with magsub, takes the sign of the larger, and returns 0 on an exact cancellation. The browser skips all 3 tests because its runner does not know assert_eq yet; the native t27c runs all 3, all pass, none vacuous. Only a2, 1.0 plus -1.0, mixes signs, and it cancels: magsub returns 0 at once because both sizes are equal. No test subtracts two different sizes, so the sign of the larger never decides a result. The recording runs t27c test-report, then a one-line sed that adds the sizes in the branch a2 takes, and t27c test-report again: exactly one test fails, a2. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the value a2 expects; then in the spec frame find bsign and check whether a1, a2 or a3 ever depends on it.

+
t27c on gft_sadd.t27 -- opposite signs subtract, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_sadd.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

Multiply, then add

+
+

You will learnWhat a multiply-accumulate does with two signed products, and how the swap from lesson 12 breaks it.

A neuron sums products of weights and inputs, and on_comb in gft_signed_mac.t27 is such a sum with two terms: smul(a1, b1) plus smul(a2, b2). Here smul sets the sign with XOR and has no zero guard. The native t27c runs 4 tests and all pass; one of them, zero_clause, expects 0 x 1 + 0 x 1 to give 512, which is 2^-39, not 0, and its comment calls that the designed behaviour. The browser skips its tests because its runner does not know assert_eq yet. The recording runs t27c test-report, then repeats the bug of lesson 12 with a one-line sed that swaps XOR for OR, and runs t27c test-report again. Exactly one test fails, pp: (-1.0) x (-1.0) now comes out negative, so the sum is 0 instead of 2.0. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the test that expects 512 and the test the planted bug breaks; then in the spec frame change the XOR in smul to OR yourself and see whether the browser catches it.

+
t27c on gft_signed_mac.t27 -- multiply, then add, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_signed_mac.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · Parts of a neuron

A ReLU that bends at zero, a power of two for softmax, and an argmax that names the answer.

+
+
16

Lesson 16 of 27

A bend at zero

+
+

You will learnWhy a ReLU needs a test with a negative input before anyone can say it bends.

A neuron passes its sum through an activation, and in gft_relu.t27 that is relu(x) = max(0, x). on_comb returns 0 for zero and for any input with the sign bit set, and x itself otherwise. The header says ReLU has an exact 0/1 gradient and that a 2-layer ReLU net solves XOR, which a linear GF-T model cannot. The browser skips all 4 tests because its runner does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that lets negative inputs through, which turns relu into the identity, a straight line, and t27c test-report again. Exactly one test fails, negz; no other test has a negative input. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the value negz expects; then in the spec frame find the comment on that line and check whether it still describes the code after the change.

+
t27c on gft_relu.t27 -- a bend at zero, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_relu.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

Two to the x

+
+

You will learnHow exp2 splits x into a whole part and a fraction, and why its tests only reach the whole part.

The header of gft_exp2.t27 calls exp2 the missing building block for a GF-T softmax. on_comb splits x into a whole part k and a fraction f: k sets the offset, k + 40, and pow2_frac turns f into the mantissa. The header claims at most 1 ULP of error, measured in the prototype, but all 4 tests use whole inputs, 0, 1.0, -1.0 and 2.0, so f is 0 and pow2_frac returns 0 whatever its coefficients. The browser skips all 4 tests because its runner does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that drops the minus sign of k for negative x, and t27c test-report again: exactly one test fails, em1: 2^-1 comes out as 2.0, not 0.5. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the value em1 expects; then in the spec frame find pow2_frac and work out what it returns when f is 0.

+
t27c on gft_exp2.t27 -- two to the x, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_exp2.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

Pick the largest

+
+

You will learnHow argmax names a class by comparing bits alone, and which rule settles a tie.

A classifier ends by naming the class with the largest score. gft_argmax4.t27 does it with no arithmetic: gt ranks negatives below zero and zero below positives, then compares the low 16 bits, which grow with the size. Its header says the lowest index wins ties, strict >. The browser skips all 4 tests because its runner does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that turns > into >= for two positive scores, and t27c test-report again: exactly one test fails, tie_low: four scores of 1.0 now pick index 3, not 0. No test lets two negative scores decide the answer: reversing their comparison fails nothing. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find the line that compares two negative scores and the one test that reaches it.

+
t27c on gft_argmax4.t27 -- pick the largest, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_argmax4.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · Learning from a mistake

A loss that prices a wrong guess in bits, one step that moves a weight against its gradient, and the hidden layer that XOR needs.

+
+
19

Lesson 19 of 27

A loss in bits

+
+

You will learnHow the loss -log2(p) prices a guess in bits, and why a perfect guess must cost exactly 0.

Training starts with a number for how wrong a guess was. gft_nll.t27 takes p, the probability the model gave the true class, and returns -log2(p): p = 1.0 costs 0, p = 0.5 costs 1 bit, and p = 0.25 costs 2. on_comb is neg(log2v(p)), and neg flips the sign bit, except that it returns 0 for 0. One header line still says the output is log2(x); the code returns its negative. The browser skips all 3 tests because its runner does not know assert_eq yet; the native t27c runs all 3, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that makes neg return 65536 for 0, a zero with the sign bit set, and t27c test-report again: exactly one test fails, perfect. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find the header line that says the output is log2(x) and compare it with on_comb.

+
t27c on gft_nll.t27 -- a loss in bits, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_nll.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

One step downhill

+
+

You will learnHow one SGD step moves a weight against its gradient, and why a test with two equal inputs cannot tell them apart.

gft_sgd_step.t27 moves a weight against its gradient: w' = w - eta*g, where eta is the learning rate. Its 3 tests are step, with w = 1.0, g = 0.5 and eta = 0.5; nograd, where g = 0 leaves w alone; and ascend, where g = -1.0 and eta = 1.0 push w up to 2.0. The browser skips all 3 tests because its runner does not know assert_eq yet; the native t27c runs all 3, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that multiplies g by itself instead of by eta, and t27c test-report again. In step g equals eta, and in nograd both products are 0. So exactly one test fails, ascend, where the weight falls to 0 instead of rising to 2.0. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find step and decide which of its inputs must change for it to catch the bug.

+
t27c on gft_sgd_step.t27 -- one step downhill, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_sgd_step.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

XOR needs a bend

+
+

You will learnWhy a network needs a hidden ReLU layer to compute XOR, and what one missing bend does.

XOR is 1 when exactly one input is 1, and a comment in gft_xornet.t27 says a single linear model cannot separate it. on_comb is a 2-layer net: two hidden sums, z0 and z1, each through relu, then a weighted sum of h0 and h1. It does not train: the tests pass hand-set weights, the analytic solution W=[[1,1],[1,1]], c=[0,-1], v=[1,-2]. The browser skips all 4 tests because its runner does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that removes relu from h1 alone, and t27c test-report again: exactly one test fails, x00: at (0,0) z1 is -1.0, and the output becomes 2.0 instead of 0. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame work out z1 for x10, x01 and x11 and see why relu changes nothing there.

+
t27c on gft_xornet.t27 -- XOR needs a bend, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_xornet.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · BitNet: ternary networks

A threshold that squeezes a sum back to three values, one neuron that becomes a different function when its weights change, and a neuron that reads its inputs 27 trits at a time.

+
+
22

Lesson 22 of 27

Back to three values

+
+

You will learnHow a threshold turns a neuron's sum back into a trit, and why each edge of the dead band needs its own test.

A neuron in a ternary network adds up products of trits, and the sum can be any small integer. quantize in activation_quantizer.t27 squeezes it back: above the threshold it returns 2 (P), below minus the threshold 0 (N), and in between 1 (Z). The on_comb at the end makes it combinational: no register, the output follows the inputs. The browser skips all 7 tests because its runner does not know assert_eq yet; the native t27c runs all 7, all pass, none vacuous. The recording changes > to >= on line 6, so a sum equal to the threshold already counts as P. Exactly one test fails, quantize_boundary_hi, which asks quantize(10, 10) for Z. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find quantize_boundary_lo and work out which one-character change on line 7 it would catch.

+
t27c on activation_quantizer.t27 -- Quantize at the edge, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/activation_quantizer.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

Same neuron, new weights

+
+

You will learnHow one ternary neuron computes a majority vote with one set of weights and a different function with another.

maj3 in bitnet_majority.t27 packs three trits with pack3, takes dot27 against w_all_p, an all-P weight chunk, and quantizes at 0: the result is the sign of a + b + c. weighted_vote is the same neuron with weights pack3(2, 2, 0) and gives the sign of a + b - c, so the weights pick the function. The browser skips all 12 tests because it does not know assert_eq yet; the native t27c runs all 12, all pass, none vacuous. The recording lowers w_all_p by 16, which turns the weight on lane 2 from P to Z, so maj3 no longer sees c. Exactly one test fails, maj_p_n_n: +1 - 1 - 1 is N, but +1 - 1 is Z. Note that wv_p_z_p passes 0, which is N, as its middle input. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the expected and the actual value of maj_p_n_n; then in the spec frame find wv_p_z_p and work out what weighted_vote(2, 1, 2) would return.

+
t27c on bitnet_majority.t27 -- One neuron, two functions, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/bitnet_majority.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

A neuron in chunks

+
+

You will learnHow a neuron with more than 27 inputs adds up its dot products chunk by chunk, and why a test with zero chunks matters.

One packed chunk holds 27 trits, so a wider neuron needs several. neuronN in bitnet_neuron_nchunk.t27 takes up to 8 chunks of activations and weights, adds dot27 for nchunks pairs starting at chunk 0, and quantizes the total. The browser skips all 11 tests because it does not know assert_eq yet; the native t27c runs all 11, all pass, none vacuous. The recording changes the loop bound on line 36 from nchunks to 1, so the neuron always reads exactly one chunk. The other neuron tests fill every chunk alike, so one chunk lands on the same side of the threshold. Exactly one test fails, neuron_zero_chunks, which asks for no chunks and expects Z. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the loop line before and after the change; then in the spec frame find neuron_two_chunks and explain why the same bug does not break it.

+
t27c on bitnet_neuron_nchunk.t27 -- A neuron over N chunks, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/bitnet_neuron_nchunk.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · The ternary MAC as a chip

The 27-trit dot product as wires with no register, the same sum added into a register on every clock, and a small whole network to close the course.

+
+
25

Lesson 25 of 27

A dot product made of wires

+
+

You will learnWhat on_comb turns a spec into, and how one wrong sign in tmul shows up in exactly one test.

on_comb in comb_ternary_dot.t27 is combinational: the generated Verilog drives result with one assign and no register, so the output follows the inputs. It adds tp over all 27 lanes of a and b, and tp calls tmul, which returns 0 if either trit is Z, +1 if they match and -1 otherwise. So N times N is +1, and dot_all_n_x_all_n expects 27. The browser skips all 4 tests because it does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording changes return -1 to return 1 on line 22, and exactly one test fails, dot_all_n_x_all_p, the one test that sets N against P. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the tmul line that changes and the test that fails; then in the spec frame find dot_all_n_x_all_n and explain why it expects 27 and not -27.

+
t27c on comb_ternary_dot.t27 -- The dot product as wires, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/comb_ternary_dot.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

Add it up on every clock

+
+

You will learnWhat on_clock adds to the dot product, and why this spec's tests never reach the register.

stream_ternary_mac.t27 keeps the same dot27 and adds a register, acc, and on_clock, which adds dot27(a, b) to acc. on_clock is clocked: it runs once per clock edge, and acc holds its value between edges. In the generated Verilog, rst_n low clears acc and acc changes only while en is high; the spec itself has no en. The native t27c runs all 4 tests, all pass, none vacuous; the browser skips them for want of assert_eq. All 4 call dot27 and none drives on_clock, so the test-waves widget, not a test, checks the accumulate line. The recording narrows the mask for a on line 26 from 3 to 1, so a P in a reads as N, and exactly one test fails, dot_all_p_x_all_p. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the mask that changes and the test that fails; then in the spec frame find on_clock and check that no test calls it.

+
t27c on stream_ternary_mac.t27 -- Accumulate on the clock, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/stream_ternary_mac.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

A whole network

+
+

You will learnHow the pieces of this course fit into one small network, and what its tests and its Verilog still leave open.

mlp2 in bitnet_mlp.t27 is a whole network: 3 neurons read the input, pack3 packs their 3 trits into a hidden chunk, and 2 neurons turn it into 2 output trits. The course went from number formats and arithmetic to a neuron, training, ternary weights and the chip; here are the neuron, the weights and an on_comb entry, and no training. The native t27c runs all 4 tests, all pass, none vacuous; the browser skips them, and none calls mlp2. The generated Verilog marks the chunk loop in neuronN NOT UNROLLED, and its note says yosys rejects it, so it is not yet a chip. The recording moves the third hidden trit from bit 4 to bit 3 on line 39, and exactly one test fails, pack3_zzz. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the pack3 line before and after the change; then in the spec frame open Code, pick verilog and find the loop in neuronN marked NOT UNROLLED.

+
t27c on bitnet_mlp.t27 -- A whole ternary network, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/bitnet_mlp.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · Lab: our own research
    1. 01 T27: a number format of our own
    2. 02 An honest scoreboard
    3. 03 A model's tables on the board
  2. 02 · AI numbers: the MX block
    1. 04 One scale for a block of weights
    2. 05 The scale byte on a real machine
    3. 06 One outlier, many zeros
  3. 03 · Ternary weights
    1. 07 Weights of minus phi, zero and plus phi
    2. 08 A pass that checked nothing
    3. 09 Five rules for a weight alphabet
  4. 04 · The Ternary Network Float
    1. 10 Blocked is not failed
    2. 11 A float whose exponent is four trits
    3. 12 Negate twice, get the number back
  5. 05 · Arithmetic on signed numbers
    1. 13 A sign is one bit
    2. 14 Opposite signs subtract
    3. 15 Multiply, then add
  6. 06 · Parts of a neuron
    1. 16 A bend at zero
    2. 17 Two to the x
    3. 18 Pick the largest
  7. 07 · Learning from a mistake
    1. 19 A loss in bits
    2. 20 One step downhill
    3. 21 XOR needs a bend
  8. 08 · BitNet: ternary networks
    1. 22 Back to three values
    2. 23 Same neuron, new weights
    3. 24 A neuron in chunks
  9. 09 · The ternary MAC as a chip
    1. 25 A dot product made of wires
    2. 26 Add it up on every clock
    3. 27 A whole network
+ + + + + diff --git a/apps/website/public/learn/ai-numbers/index.html b/apps/website/public/learn/ai-numbers/index.html index 76f0039c7d..a8d40abd3e 100644 --- a/apps/website/public/learn/ai-numbers/index.html +++ b/apps/website/public/learn/ai-numbers/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

AI numbers with t27: from number formats to a ternary network

It picks up where the FPGA course ends. Every lesson opens a real tool or a recording of t27c and Zig on a real machine, next to a spec you can run in your browser.

Course 2, 27 lessons, one widget and one t27 spec each: a number format of our own, the OCP MX block formats AI chips use, ternary weights and the Ternary Network Float, then signed arithmetic, the parts of a neuron, a training step, BitNet ternary neurons and the ternary MAC as logic. Every new lesson plants one bug and shows the test that catches it.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/all/card.png b/apps/website/public/learn/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..8353575b6b369f0551fd54b1561c1b5577b57c2f GIT binary patch literal 33931 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 U6#W(1^VLvM)Kn;ufBW(O03490#sB~S literal 0 HcmV?d00001 diff --git a/apps/website/public/learn/all/index.html b/apps/website/public/learn/all/index.html new file mode 100644 index 0000000000..65ef0050d5 --- /dev/null +++ b/apps/website/public/learn/all/index.html @@ -0,0 +1,482 @@ + + + + + + +t27 basics: the language in 27 lessons: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

t27 basics: the language in 27 lessons

+

Before the FPGA course: what a t27 spec is, how the compiler reads it, and what it gives back. Every lesson opens one table or diagram drawn from its own spec and one spec you can run in your browser.

+

Course 0, 27 lessons, one infographic and one t27 spec each: a module, constants and types, functions and tests, then the compiler's stages and the 7 languages it writes. It comes before the FPGA course.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · A spec file

What a .t27 file holds: a module line, prose lines and comments.

+
+
01

Lesson 1 of 27

What a spec is

+
+

You will learnWhat goes into a .t27 file and what the compiler gives back for it.

A spec is a plain text file that ends in .t27. It opens with a module line, declares values and functions, and carries test blocks that check them. The compiler, t27c, reads the file and answers with a verdict and code for 7 backends. The spec under this lesson has 2 constants and 1 test, and the site compiles it in your browser.

Try it

Open the lesson spec in the player and find its three parts: the module line, the constants, the test.

+
t27 basics 1: the three parts of a specThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/01_what_a_spec_is.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

The module line

+
+

You will learnHow to write the module line, which names it accepts, and where it goes.

The module line is the keyword module, a name and a semicolon. Comment and prose lines may come before it; declarations come after. Names use letters, digits and underscores; the compiler in this site also accepts hyphens, as in tutorial-06-structs. A course spec on this site must use the module name its generator expects, so a wrong name is caught by the build and not by the compiler.

Try it

In the player, change the module name of this lesson spec and watch the verdict stay clean.

+
t27 basics 2: the module lineThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/02_the_module_line.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

Comments and prose lines

+
+

You will learnWhere each kind of note may stand, and the one line that breaks the parser.

A line that starts with a semicolon is prose: the compiler skips the rest of the line. Prose lines stand at the top level, between declarations. Two slashes start a comment anywhere, after code or inside a test. One trap: a semicolon alone on its line is not an empty prose line, it is a parse error, and the whole spec fails. Put a word after it, or leave the line empty.

Try it

Add a line with a lone semicolon to the lesson spec in the player, read the error, then remove it.

+
t27 basics 3: where comments may standThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/03_comments_and_prose.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · Values and types

Constants, the width of a whole number, and true, false and text.

+
+
04

Lesson 4 of 27

Constants

+
+

You will learnThe six pieces of a constant declaration and what each one does.

pub const WIDTH : u8 = 8; reads left to right: pub makes the name visible to other modules, const says the value is fixed, WIDTH is the name, u8 is the type, 8 is the value, and the semicolon ends it. Constants are what this site's test runner can check: the lesson spec declares WIDTH, HEIGHT and AREA and tests that 8 times 4 is 32.

Try it

Change AREA in the lesson spec to 33 and watch which test fails.

+
t27 basics 4: a constant, piece by pieceThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/04_constants.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

Whole numbers and their widths

+
+

You will learnThe integer types, their ranges, and the error a value too big for its type gets.

A u in the type name means unsigned, an i means signed, and the digits are the number of bits. u8 holds 0 to 255, u16 holds 0 to 65535, i32 holds negative numbers too. The compiler checks a constant against its type: give a u8 the value 300 and it stops with an error that says no u8 can hold 3 digits. The browser's checker is lenient elsewhere, so do not read its silence as proof.

Try it

Set BYTE_MAX to 300 in the player and read the error the compiler prints.

+
t27 basics 5: integer widths and their rangesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/05_whole_numbers.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

True, false and text

+
+

You will learnHow to declare a bool and a str, and what a test can compare them with.

A bool is true or false. A str is text in double quotes, and the text may hold characters that mean something elsewhere in t27, such as a semicolon or two slashes: inside quotes they are just text. A test compares a bool or a str with == and !=. One honest limit: the checker in this browser does not stop a str given to a u8 constant, so keep types and values matched yourself.

Try it

Change NAME in the lesson spec and fix the test so that it passes again.

+
t27 basics 6: bool and strThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/06_true_false_and_text.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · Arrays, trits and expressions

Lists of values, the three values of a trit, and what operators compute.

+
+
07

Lesson 7 of 27

Arrays

+
+

You will learnHow to declare an array, read an item, and which index is the last one.

An array type is the length in square brackets followed by the item type: [5]u8 is five unsigned bytes. The value lists the items in square brackets. Index 0 holds the item at the start, so in an array of 5 the last index is 4. A test reads an item with PRIMES[4]. Keep the declared length and the list in step: the checker in this browser does not catch a length that disagrees with the list.

Try it

Add a sixth prime to PRIMES, fix the length, and write an assert for index 5.

+
t27 basics 7: an array and its indexesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/07_arrays.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

Trits: minus one, zero, one

+
+

You will learnHow a trit is written as a small signed constant and why 27 shows up everywhere.

A bit has two values; a trit has three: minus one, zero and one. The lesson spec writes them as i8 constants NEG, ZERO and POS, the way the tutorial specs of t27 do. Adding POS and NEG gives ZERO. Three trits have 3 times 3 times 3 combinations, which is 27: the number of lessons in this course and the cells of a TRI-27 word.

Try it

Write an assert that POS minus NEG equals 2, and check it passes.

+
t27 basics 8: three values of a tritThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/08_trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Expressions

+
+

You will learnArithmetic operators and comparisons on the lesson constants, and the bool a comparison gives back.

An expression combines names and numbers with operators. With A = 17 and B = 5, A + B is 22, A - B is 12, A * B is 85, A / B is 3 because whole numbers divide without a fraction, and A % B is 2, the remainder. Comparisons give true or false. One limit of the test runner on this site: it does not read a minus sign in front of a number, so write negative values as constants.

Try it

Change B to 4 and predict each of the five results before you run the tests.

+
t27 basics 9: operators on two numbersThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/09_expressions.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · Tests and functions

A test block, several small tests in one spec, and a function with typed inputs.

+
+
10

Lesson 10 of 27

A test block

+
+

You will learnHow a test block is written and what a failing assert reports.

A test block starts with the keyword test and a name, and holds assert lines in braces. Each assert takes an expression that must be true. When one is false, the report names the test and the number of the assert, for example assert #1 is false. A spec's tests are its claims about itself, which is why every course spec on this site carries some.

Try it

Break the test on purpose by changing DAYS, then read the failure line.

+
t27 basics 10: a test block, passing and failingThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/10_a_test_block.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

Many tests in one spec

+
+

You will learnWhy several small tests read better than one long one, and how the report counts them.

A spec may hold any number of test blocks. Each one checks one idea and has a name that says which. The report counts tests and asserts separately: the lesson spec has 3 tests and 5 asserts. When one fails, its name tells you which idea broke, and the other tests still report on their own ideas.

Try it

Make one of the three tests fail and check that the other two still pass.

+
t27 basics 11: three tests, one idea eachThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/11_many_tests.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

Functions

+
+

You will learnThe two ways t27 writes a function signature, and the body with return.

fn add(a: u8, b: u8) -> u8 declares a function with two u8 inputs and a u8 result; the body in braces ends with return. The compiler also accepts the Zig style, pub fn add(a: u8, b: u8) u8, without the arrow. There are no generics: fn id<T> is a parse error. The test runner on this site checks constants and does not call functions, so the lesson keeps the expected results as constants beside them.

Try it

Write a function sub in the player in either style and check the verdict stays clean.

+
t27 basics 12: a function signature, piece by pieceThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/12_functions.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · Inside a function

Names with let and var, choices with if and switch, and loops.

+
+
13

Lesson 13 of 27

Local names: let and var

+
+

You will learnWhen to use let and when var, and how a var is updated.

let a = w * h; gives a name to a value inside a function body. var i : u8 = 0; declares a name that may change, and i = i + 1; changes it. Use let when the value is computed once, var when a loop updates it. These names live only inside the function; the module level uses const.

Try it

Change let to var in area and check the verdict; then explain why let reads better there.

+
t27 basics 13: let, var and constThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/13_local_names.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Choices: if, else and switch

+
+

You will learnThe forms of if the compiler accepts, the if expression, and switch with else.

if (a > b) { ... } else { ... } runs one of two blocks. The parentheses are optional: if a > b { ... } also compiles. if can be an expression too: return if (a > b) a else b; gives the larger one. switch (m) { 0 => 10, else => 20 } picks a value by matching m, and else covers every other case.

Try it

Add a case 1 => 15 to the switch in the player and check the verdict.

+
t27 basics 14: the shapes of a choiceThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/14_if_and_else.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

Loops: while and for

+
+

You will learnThe three loop forms the compiler accepts and how a range is written.

while (i < n) { i = i + 1; } repeats its block while the condition is true, and the block must move toward making it false. for i in 0..n { } walks i from 0 up to n, with n itself left out. The compiler also accepts the Zig form, for (0..4) |i| { }. A loop usually updates a var declared before it.

Try it

Work out by hand what sum_to returns for n = 4, then write it as a constant with a test.

+
t27 basics 15: three loop formsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/15_loops.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · Visibility and your own types

What pub shares with other modules, and the structs and enums you declare.

+
+
16

Lesson 16 of 27

pub or private

+
+

You will learnWhat pub declares, and what the TypeScript backend writes with and without it.

pub in front of const, fn, struct or enum says other modules may use the name. Without pub the name is meant for the module itself. Today the compiler does not enforce this in the code it writes: gen-ts exports both the pub and the private constant of the lesson spec. Use pub to say what a module offers, and read the generated code before relying on privacy.

Try it

Open the ts tab of the lesson spec in the player and find both constants.

+
t27 basics 16: what pub changes in the generated codeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/16_pub_or_private.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

Structs

+
+

You will learnHow to declare a struct and a packed struct, and how many a module may hold.

pub struct Point { x: i32, y: i32 } declares a type with two fields. Fields are a name and a type, separated by commas. A packed struct lays its fields next to each other with no padding, the shape a hardware register has. A module may declare several structs; the lesson spec has two, and the verdict stays clean on all 7 backends.

Try it

Add a field z: i32 to Point and check which backends still compile it.

+
t27 basics 17: a struct and its fieldsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/17_structs.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

Enums

+
+

You will learnThe two ways to declare an enum and how a switch reads a value.

pub enum Color { Red, Green, Blue } names three cases. The Zig form pub const Mode = enum(u8) { Idle, Run } also fixes the type that stores a case, here u8. A switch over a value lists what each case gives and uses else for the rest. Both forms compile clean on all 7 backends in the lesson spec.

Try it

Add a fourth color to Color and update CASES_IN_COLOR so the test passes.

+
t27 basics 18: two ways to write an enumThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/18_enums.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · Modules, rules and gen-ts

Reading another module, stating a rule that always holds, and a spec turned into TypeScript.

+
+
19

Lesson 19 of 27

Using other modules

+
+

You will learnHow a use line is written, and what the browser can and cannot do with it.

use base::types; names a module by its path, with :: between the parts. The parser reads it as a use declaration. The compiler in your browser has no checkout of the other files, so it does not open base::types and does not check names that come from it. The native t27c resolves imports from a repository; this lesson could not run that check here.

Try it

Find the use declaration in the parser tree of the lesson spec in the player.

+
t27 basics 19: what a use line does in the browserThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/19_use_other_modules.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

Invariants and benches

+
+

You will learnHow invariant and bench blocks are written and who evaluates them.

invariant name followed by an assert states a rule of the spec that must hold for every value, not one example. bench name marks a block to time. Both compile. The test runner on this site evaluates test blocks only: it skips invariants and benches, so a false invariant passes here silently. The lesson spec repeats its invariant as a test for that reason.

Try it

Make the invariant false in the player and check that nothing on this site complains, then make the test false.

+
t27 basics 20: test, invariant and benchThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/20_invariants.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

gen-ts: a spec becomes TypeScript

+
+

You will learnWhat gen-ts writes for constants and functions, and how a host program uses it.

t27c gen-ts turns each constant into an export const line that TypeScript type-checks. Functions are not emitted: the backend says it lowers declarations, not bodies. This is how this site uses specs: a generator reads a .t27 file and writes the numbers and words a page imports. The table under this lesson shows what gen-ts wrote for the lesson spec.

Try it

Add a constant to the lesson spec in the player and find its line in the ts tab.

+
t27 basics 21: what gen-ts writesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/21_gen_ts.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · The compiler and tri

The backends t27c writes, the stages it reads a spec in, and the tri command.

+
+
22

Lesson 22 of 27

Seven backends

+
+

You will learnThe names of the 7 backends and how much code each wrote for one small spec.

The compiler in your browser has 7 backends: c, js, rust, ts, verilog, verilog_hir and zig. Each reads the same parsed spec and writes code in its language; the verilog_hir backend is written from the hardware view, HIR. The table shows the bytes each backend wrote for the lesson spec, measured with the compiler on this site. Bigger is not better: each language needs a different amount of text.

Try it

Open each backend tab of the lesson spec in the player and find the function add.

+
t27 basics 22: one spec, seven backendsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/22_seven_backends.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

The stages of t27c

+
+

You will learnThe order of the compiler stages and what each one produced for the lesson spec.

The lexer cuts the text into tokens. The parser builds a tree of nodes. The type checker reports errors and warnings without stopping the backends. HIR is the hardware view that the verilog_hir backend is written from; the other backends read the parser's tree. The table shows the counts each stage gave for the lesson spec, measured with the compiler on this site.

Try it

Open the t27c stages widget, paste the lesson spec, and match its counts with the table.

+
t27 basics 23: the stages of t27c, countedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/23_stages_of_t27c.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

tri: the command line

+
+

You will learnWhat tri test does, how tri hands other words to t27c, and which commands are its own.

In the gHashTag/t27 repository, scripts/tri is a small wrapper. tri test runs the conformance suite, t27c suite --repo-root .; a word tri does not know, such as gen or seal, is passed on to t27c. Its own commands include audit, recall, frontier, lesson and help. This lesson read the script and did not run it: native t27c is built on a Linux machine, and this course does not run it on yours.

Try it

Read the table and say which commands go to t27c and which stay inside tri.

+
t27 basics 24: where a tri command goesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/24_tri_commands.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · Errors, a program, what next

Reading a compiler error, one small complete program, and the course to take next.

+
+
25

Lesson 25 of 27

Reading compiler errors

+
+

You will learnHow to read the line and column of an error, using four real mistakes.

A parse error says where the parser was, near which line, and the token it did not expect, with a line and a column. A type error names the constant and why its value does not fit. Read the position first, then look one token to the left: the mistake is often just before the place the parser stopped. The table shows what the compiler on this site answered for four small mistakes.

Try it

Make each of the four mistakes in the player and match the line and column with the table.

+
t27 basics 25: four mistakes and what t27c saysThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/25_reading_errors.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

A small complete program

+
+

You will learnHow the pieces of this course make one spec that becomes a circuit.

The lesson spec has a module line, a width constant, test values and on_comb, a function of two u8 inputs. gen-verilog turns it into a module whose ports are a clock, a reset and an enable, the two 8-bit inputs a and b, a ready output and the 8-bit output result. An assign line sets result from on_comb, so the sum itself waits for no clock edge. The tests check the example sums as constants; the site runner does not call on_comb, so the check of the circuit itself is left to a simulator.

Try it

Open the verilog tab of the lesson spec in the player and find the input, output and assign lines.

+
t27 basics 26: an adder in t27 and its Verilog portsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/26_a_small_program.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

Where to go next

+
+

You will learnWhich course to take next, and what each one adds to the basics.

You can now read a spec: its module line, constants, types, functions, tests and the code its backends write. Course 1 follows a spec onto an Artix-7 FPGA: synthesis, placement, timing and a bitstream checked on a board. Course 2 builds number formats for AI in t27, from OCP MX blocks to a ternary network. Both courses have 27 lessons and open a spec in every one.

Try it

Pick the next course from the table and open its lesson 1.

+
t27 basics 27: three courses, in orderThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/basics/27_where_next.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · A spec file
    1. 01 What a spec is
    2. 02 The module line
    3. 03 Comments and prose lines
  2. 02 · Values and types
    1. 04 Constants
    2. 05 Whole numbers and their widths
    3. 06 True, false and text
  3. 03 · Arrays, trits and expressions
    1. 07 Arrays
    2. 08 Trits: minus one, zero, one
    3. 09 Expressions
  4. 04 · Tests and functions
    1. 10 A test block
    2. 11 Many tests in one spec
    3. 12 Functions
  5. 05 · Inside a function
    1. 13 Local names: let and var
    2. 14 Choices: if, else and switch
    3. 15 Loops: while and for
  6. 06 · Visibility and your own types
    1. 16 pub or private
    2. 17 Structs
    3. 18 Enums
  7. 07 · Modules, rules and gen-ts
    1. 19 Using other modules
    2. 20 Invariants and benches
    3. 21 gen-ts: a spec becomes TypeScript
  8. 08 · The compiler and tri
    1. 22 Seven backends
    2. 23 The stages of t27c
    3. 24 tri: the command line
  9. 09 · Errors, a program, what next
    1. 25 Reading compiler errors
    2. 26 A small complete program
    3. 27 Where to go next
+ + + + + diff --git a/apps/website/public/learn/an-encoder-block/index.html b/apps/website/public/learn/an-encoder-block/index.html index f9f3164f5a..1809dbe812 100644 --- a/apps/website/public/learn/an-encoder-block/index.html +++ b/apps/website/public/learn/an-encoder-block/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

An encoder block

You will learn

What one transformer encoder block does to its input, and what moving the norms in front changes.

A transformer layer is two sublayers, each wrapped in a residual add and a layer norm: self-attention mixes the positions, then a feed-forward net of width 8 works on each position alone. In the post-norm order of the original paper the block ends with a norm, so every output row has mean 0 and variance 1.000. Pre-norm puts the norms in front of each sublayer and ends on a residual add, so its rows come out at variances 2.73, 3.33 and 0.96; deep stacks train more easily that way, with one norm added at the very top. The spec encoder_block.t27 runs one block on 3 positions, d_model 4 and 2 heads.

Try it

Switch between post-norm and pre-norm and read the row variances; then find the position head 1 reads most.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

An encoder block: what one transformer layer does
An encoder block: what one transformer layer does ↗

Three positions through one transformer block: attention, a residual, a feed-forward net and layer norm. Post-norm ends every row at mean 0 and variance 1; pre-norm does not.

specs/ml/transformer/encoder_block.t27

// SPDX-License-Identifier: Apache-2.0
@@ -439,6 +471,7 @@ 

An encoder block

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/an-honest-scoreboard/index.html b/apps/website/public/learn/an-honest-scoreboard/index.html index f34ebabfd5..fba12819ee 100644 --- a/apps/website/public/learn/an-honest-scoreboard/index.html +++ b/apps/website/public/learn/an-honest-scoreboard/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

An honest scoreboard

You will learn

How T27 was compared with NVFP4, MX+ and MXFP4 on a real language model, and what the result does not show.

A format is judged by what it does to a model. We stored the weights of one small language model in each format and measured perplexity on text it had not seen: lower is better. The rule was written before the run: T27 beats a rival when its perplexity is below 990 thousandths of the rival's. It beat NVFP4, MX+ and MXFP4, and it lost to E2M2, a wider format. The panel under the bars lists what this test cannot claim. The one claim that holds: T27 beats NVFP4 on a ternary substrate.

Try it

Find the NVFP4 ratio and the threshold line; then name the format T27 loses to and what it pays for that. The spec frame is a control for another claim: find what its header says a posit match would falsify, and the test that holds es at 2 for every width.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

T27 vs NVFP4: six weight formats on one small language model
T27 vs NVFP4: six weight formats on one small language model ↗

Perplexity of six weight formats on SmolLM2-135M and the pre-registered ladder: T27 better than NVFP4, MX+ and MXFP4 on a trit substrate, worse than E2M2. Every limit listed.

specs/numeric/posit_ladder_control.t27

// SPDX-License-Identifier: Apache-2.0
@@ -208,6 +240,7 @@ 

An honest scoreboard

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/anatomy-of-a-tb/index.html b/apps/website/public/learn/anatomy-of-a-tb/index.html index b00e33c38c..204fd12fdb 100644 --- a/apps/website/public/learn/anatomy-of-a-tb/index.html +++ b/apps/website/public/learn/anatomy-of-a-tb/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Anatomy of a testbench

You will learn

The parts every *_tb.t27 spec has: stimulus, expected values, checks, a verdict.

Every testbench in this repo is one .t27 file with the same skeleton, and the player compiles it like any other spec. Open fifo_tb: it builds the stimulus (bytes into a FIFO), the expected values (the same bytes, in order), the checks (one assert per invariant, so a failure names the one that broke), and a verdict (a count, not a feeling). The widget generates JavaScript from a spec in the browser and runs it -- the same generate-then-execute shape a testbench uses, small enough to watch happen.

Try it

Generate JavaScript for the fifo_tb spec in the player and run it; find the assert that would fail first if the FIFO dropped a byte.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

hello_world.t27 to JavaScript, in a terminal inside the post
hello_world.t27 to JavaScript, in a terminal inside the post ↗

A terminal in your browser running the t27 compiler as WebAssembly: t27c gen js prints the JavaScript it emits for hello_world.t27, and t27c test runs the spec's tests.

specs/fpga/testbench/fifo_tb.t27

// FIFO testbench spec
@@ -302,6 +334,7 @@ 

Anatomy of a testbench

}

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/angle-and-magnitude/index.html b/apps/website/public/learn/angle-and-magnitude/index.html index d88a2abb55..cd33b2f67e 100644 --- a/apps/website/public/learn/angle-and-magnitude/index.html +++ b/apps/website/public/learn/angle-and-magnitude/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Angle and magnitude

You will learn

How CORDIC vectoring mode gives atan2 and the length of a vector without a divider.

Vectoring mode steers the other way: it turns the vector down onto the x axis and collects the angle it turned through. What is left on the x axis is the length, stretched by 1/K(n), about 1.6467602581, so one multiply by K(n) gives the magnitude. A vector in the left half-plane is first turned by 90 degrees. For (3, 4), 16 steps give a length of 5.000000 and an angle of 53.13 degrees. The spec cordic.t27 computes the steps and the references.

Try it

Drag the point into each quadrant and compare the angle with what you expect; then set 8 steps and read how far y is from 0.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

CORDIC vectoring: angle and length without a divide
CORDIC vectoring: angle and length without a divide ↗

Drag a point and watch CORDIC turn its vector down onto the x axis, step by step, reading off atan2 and the magnitude with shifts and adds.

specs/fpga/dsp/cordic.t27

// SPDX-License-Identifier: Apache-2.0
@@ -437,6 +469,7 @@ 

Angle and magnitude

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/arithmetic-and-dsp/all/card.png b/apps/website/public/learn/arithmetic-and-dsp/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..55bb61ee2876af70178a16106eca96f0c8656ac4 GIT binary patch literal 39062 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 YYOT}N2(ib2@7$4-QkJX`HxB%N0I0#P8UO$Q literal 0 HcmV?d00001 diff --git a/apps/website/public/learn/arithmetic-and-dsp/all/index.html b/apps/website/public/learn/arithmetic-and-dsp/all/index.html new file mode 100644 index 0000000000..37b7fbb85e --- /dev/null +++ b/apps/website/public/learn/arithmetic-and-dsp/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Arithmetic and DSP on the FPGA: from the carry chain to a filter: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

Arithmetic and DSP on the FPGA: from the carry chain to a filter

+

It picks up where the buses course ends. Every widget in it runs the fn bodies of a t27 spec compiled to WebAssembly: move a slider and the spec answers.

+

Course 9, 27 lessons, a live widget and a t27 spec each: adders and carry chains, multipliers and the DSP48E1 slice, fixed point, CORDIC, sampling, FIR and CIC filters, the FFT, and a filter on the bench. Every number is computed by a compiled spec.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · Adding numbers

Why addition is slow: the carry that walks up the word, the dedicated chain in every slice, prefix networks and carry-save trees.

+
+
01

Lesson 1 of 27

The carry chain

+
+

You will learnWhy a carry walks the whole word, and how the dedicated chain of a slice makes the walk cheap.

Bit i of a + b is the XOR of a_i, b_i and the carry into it, and the carry out is their majority. A carry made at bit 0 of 127 + 1 has to pass through bits 1 to 6 before the top bit knows its answer: the widget lights that run of 7. Recomputing the carry in a LUT costs a LUT and a route per bit; the dedicated chain of a 7-series slice costs one LUT and one route, then one hop per bit, in CARRY4 blocks of 4 bits. The spec adders.t27 states both models and leaves the three delays to you.

Try it

Load 127 + 1 and find the longest carry run; then switch to 85 + 170 and explain why the run is 0. Set the hop to 30 ps and compare the two delays for 32 bits.

+
The carry chain: why adding is slow, and how a slice makes it fastThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/adders.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

Looking ahead: prefix adders

+
+

You will learnHow a prefix network computes every carry in log2 n levels, and what Kogge-Stone, Sklansky and Brent-Kung pay for it.

The carries of an adder are prefixes of one associative operator, so they can be computed as a tree instead of a chain. The widget draws four networks from the spec's src() function, one dot per prefix cell. At 16 bits ripple needs 15 levels; Kogge-Stone needs 4 levels and 49 cells, Brent-Kung 7 levels and 26 cells, Sklansky 4 levels and 32 cells with a fanout of 8. The spec does not take the counts on trust: covers() replays each network on spans and checks that every column ends up covering bits 0 to i.

Try it

At 16 bits, tap bit 15 in each network and count the white dots; then name the network with the fewest levels and the one with the fewest cells.

+
Prefix adders: trade logic levels for cells and wiresThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/adders.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

Three numbers at once

+
+

You will learnHow 3:2 counters add many numbers with almost no carry propagation, and how many layers k numbers need.

A 3:2 counter is a row of full adders with nothing between them: three numbers in, a sum word and a carry word out, and the two add up to the three. Layers of them squeeze k numbers to two before one ordinary adder finishes. The Dadda heights 2, 3, 4, 6, 9, 13, 19, 28, 42, 63 are the most numbers each count of layers can reduce, so 9 numbers need 4 layers and 64 need 10. For 9 numbers of 16 bits that is 20 full-adder delays against 128 for a chain of adders.

Try it

Set 28 numbers and then 29: how many layers does each need, and why does one more number cost a layer? Then check that sum + carry equals a + b + c in the counter below.

+
Carry-save adders: add many numbers with almost no carriesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/adders.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · Multiplying

A product is a sum of shifted copies; Booth recoding halves them, and the DSP48E1 slice does the rest in one block.

+
+
04

Lesson 4 of 27

Shift and add

+
+

You will learnWhy a multiplier is a pile of shifted partial products, and how many of them a number costs.

Every 1 bit of the multiplier adds a copy of the multiplicand shifted by that bit's position; every 0 bit adds nothing. 200 x 13 is 200 + 800 + 1600 = 2600, three rows out of eight. Two 8-bit numbers make at most a 16-bit product, and an array multiplier is exactly this grid of AND gates feeding the carry-save trees of the last lesson. The spec multipliers.t27 computes each row and the running sum the widget draws.

Try it

Step through 200 x 13 row by row; then find a multiplier b from 0 to 255 that makes all eight rows add, and one that makes only one.

+
Shift and add: a multiplier is a pile of shifted copiesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/multipliers.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

Booth's trick

+
+

You will learnHow radix-4 Booth recoding turns eight rows into four and handles signed numbers with no special case.

Read the multiplier three bits at a time, overlapping by one, with an implicit 0 below bit 0. Each group becomes a digit from -2 to +2, and each digit one partial product: digit x a x 4^k. For 3 x 6 the digits of 6 are -2, +2, 0, 0, so the product is -6 + 24 = 18. The negative digits are what make two's complement work without a correction step. The spec checks the recoding against a x b for every pair of 8-bit numbers, all 65536 of them.

Try it

Load -128 x -128 and read the digits; then compare the Booth rows that add with the shift-and-add rows for b = 127.

+
Booth's trick: half the partial products, signs for freeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/multipliers.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

The DSP48E1 slice

+
+

You will learnHow a product is tiled onto 25 x 18 multipliers and how many terms the 48-bit accumulator can sum.

A DSP48E1 slice multiplies a 25-bit by an 18-bit two's complement number into a 48-bit accumulator, and the XC7A200T has 740 of them. A 25 x 18 product needs 43 bits, so the accumulator keeps 5 bits of headroom: 32 terms sum safely and the 33rd can overflow. A wider product is cut into pieces, the low ones one bit short of the port because they are unsigned: 32 x 32 takes 4 slices. The spec multipliers.t27 holds the tiling, the guard bits and the headroom.

Try it

Find the widest b that still fits one slice next to a 25-bit a; then set 16 x 16 and find the largest number of terms the accumulator holds.

+
The DSP48E1 slice: fit a x b and its running sumThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/multipliers.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · Fixed point

Where the binary point sits, what rounding does to a value and to its average, and what each bit of a quantizer buys.

+
+
07

Lesson 7 of 27

Q formats

+
+

You will learnHow to read and write a Qm.n fixed-point word: its range, its step and the bits around the binary point.

Qm.n has m integer bits counting the sign and n fraction bits; the word stands for its integer value times 2^-n. Q1.15 is a 16-bit word from -1 to 0.99997 in steps of 2^-15. 0.7 has no exact Q1.15 word: the nearest is 22938, worth 0.70001. The top bit weighs minus its place, which is all two's complement is. The spec fixed_point.t27 computes the range, the step, every bit and the word a value rounds to.

Try it

Store 0.7 in Q1.15 and read the error; then switch to Q2.2 and list every value the format can hold.

+
Q formats: read and write a fixed-point numberThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/fixed_point.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

Rounding and saturation

+
+

You will learnWhat truncation, rounding and convergent rounding do to a value and to its average, and when to wrap or saturate.

Dropping low bits is truncation, and truncation is biased: on a ramp its mean error is -0.25 LSB for one dropped bit and tends to -0.5 as more go. Round half up is biased the other way, +0.25 for one bit; convergent rounding sends ties to the even neighbour and averages to 0. Outside the range a two's complement adder wraps for free, turning 1.0 into -1.0 in Q1.15; saturation costs a comparator and keeps the sign. The spec fixed_point.t27 measures all three modes on a ramp.

Try it

Store 1.25 in Q3.1 with each rounding mode and note the stored value; then drop 4 bits and read the three biases.

+
Rounding and saturation: the error you choose, and its biasThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/fixed_point.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Quantization noise

+
+

You will learnWhy each bit of a quantizer buys about 6 dB, and where the textbook formula is optimistic.

A quantizer's error is a sawtooth one step high, and its power is the step squared over 12. Against a full-scale sine that gives 6.02 N + 1.76 dB, about 74.0 dB at 12 bits. The spec signals.t27 also measures it: it quantizes a real sine over 4096 samples holding 127 periods and divides the powers. At 12 bits the two agree; at 1 bit the formula claims 7.78 dB and the measurement finds 6.44, because so coarse an error is not uniform.

Try it

Step from 1 to 4 bits and watch the gap between the formula and the measurement close; then read what the 16th bit adds.

+
Quantization noise: each bit buys about 6 dBThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · Functions in hardware

Sine, cosine, angle and length from shifts and adds, and when a table is the better answer.

+
+
10

Lesson 10 of 27

Rotating by shifts

+
+

You will learnHow CORDIC rotation mode reaches cos and sin with nothing but shifts and adds.

Turn a vector by atan(2^-i), one way or the other, at step i: the multiply by tan is a shift by i, so each step is two shifts and two adds. Steering by the sign of the angle left drives that angle to zero, and starting at K(n) instead of 1 cancels the stretch each step adds; K(n) tends to 0.6072529350. After 16 steps, 30 degrees comes out as cos 0.866018 and sin 0.500013. The spec cordic.t27 computes every step the widget draws.

Try it

Run 30 degrees with 4 steps and then with 16, and read the errors; then find the step at which the direction first turns clockwise.

+
CORDIC: rotate a vector with shifts and addsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/cordic.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

Angle and magnitude

+
+

You will learnHow CORDIC vectoring mode gives atan2 and the length of a vector without a divider.

Vectoring mode steers the other way: it turns the vector down onto the x axis and collects the angle it turned through. What is left on the x axis is the length, stretched by 1/K(n), about 1.6467602581, so one multiply by K(n) gives the magnitude. A vector in the left half-plane is first turned by 90 degrees. For (3, 4), 16 steps give a length of 5.000000 and an angle of 53.13 degrees. The spec cordic.t27 computes the steps and the references.

Try it

Drag the point into each quadrant and compare the angle with what you expect; then set 8 steps and read how far y is from 0.

+
CORDIC vectoring: angle and length without a divideThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/cordic.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

Tables and interpolation

+
+

You will learnHow many sine table entries you need, and when linear interpolation beats more entries.

A quarter-wave table of n entries answers to within about half a step between them; interpolating between two entries brings that down to h^2/8, where h is pi/2 divided by n. With 16 entries of 16 bits the nearest entry is off by up to 0.049 and the interpolated answer by 0.0012. Past a point more entries buy nothing, because the b-bit words themselves are off by up to 1/(2S). The spec cordic.t27 builds the table and measures it against its own 50-step CORDIC.

Try it

Compare 16 entries with and without interpolation; then set 256 entries and find the word width at which the words, not the entries, limit the error.

+
Sine tables: entries, word width, and interpolationThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/cordic.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · Signals and sampling

What sampling does to a frequency, how an oscillator is built from an adder, and what a DFT bin measures.

+
+
13

Lesson 13 of 27

Sampling and aliasing

+
+

You will learnWhy a tone above half the sample rate comes back as a lower one, and which way it folds.

A sampler sees a tone at f as one at |f - fs round(f/fs)|: the spectrum folds like paper at every multiple of fs/2. Sampled at 100, a tone at 70 is seen at 30, and so is one at 130. In every other Nyquist zone the fold runs backwards and the alias comes out mirrored. The time view shows why nothing after the sampler can tell: the samples of the 70 tone lie exactly on a 30 tone. The spec signals.t27 computes the fold, the zone and every point drawn.

Try it

Find three input frequencies that land on 30 at a rate of 100; then move fs and watch the corners of the triangle move.

+
Sampling and aliasing: the fold of every frequencyThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

A numerically controlled oscillator

+
+

You will learnHow a phase accumulator and a sine table make any frequency, and how fine the steps are.

Add a tuning word M to an N-bit accumulator every clock and its top bits sweep around a circle at f_out = M f_clk / 2^N. At 100 MHz with N = 32, M = 2^30 gives 25 MHz, a quarter turn per clock, and the next frequency up is 0.0233 Hz away. The top P bits of the phase address a sine table; the rule of thumb puts the worst phase-truncation spur about 6.02 dB per kept bit below the carrier. The spec signals.t27 picks M and computes every sample.

Try it

Ask for 1 MHz and read the tuning word and the frequency you actually get; then cut the table to 4 phase bits and look at the output samples.

+
The NCO: a phase accumulator and a sine tableThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

Bins of a spectrum

+
+

You will learnWhat one DFT bin measures, and why a tone between bins leaks into all of them.

A DFT of L points has L bins, each fs/L wide. A tone that fits a whole number of cycles in the window lands in one bin at 0 dB and nowhere else. Move it half a bin and the peak drops to -3.7 dB and leaks into every bin, because the DFT treats the window as one period of a repeat and the repeat jumps at the seam. A Hann window tapers the seam: at 8.5 bins on 64 points it lowers bin 20 from -33.2 dB to -73.9 dB. The spec signals.t27 computes every bin.

Try it

Slide the tone from 8 to 9 bins and watch the highest bin; then switch to Hann and compare a far bin.

+
Bins of a spectrum: one tone, and where it leaksThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · FIR filters

The moving average, a windowed-sinc design with integer taps, and folding the taps onto DSP slices.

+
+
16

Lesson 16 of 27

The moving average

+
+

You will learnWhy averaging L samples is a low-pass filter, and where its nulls fall.

Average the last L samples and a tone at f comes out multiplied by |sin(pi f L) / (L sin(pi f))|. For L = 4 that is 1 at DC, 0.65328 at 1/8 of the sample rate and exactly 0 at 1/4: every multiple of 1/L is a null. It needs no multiplier at all, which is why FPGA designs reach for it early. The spec signals.t27 computes the response and the output sample by sample.

Try it

Put the tone on the null of L = 4 and watch the output vanish; then double L and find the new null.

+
The moving average: a low-pass you can do in your headThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

Designing taps

+
+

You will learnHow a windowed-sinc low-pass is designed, and what rounding its taps to integers costs.

The ideal low-pass is a sinc; cut it to a finite number of taps and multiply by a window, and a stopband appears. With 31 taps and a cutoff of 0.1, no window leaves the stopband from 0.2 at -32.8 dB; Hamming takes it to -62.6 dB and Blackman to -76.1 dB. Then the taps become integers: at 16 bits the Hamming stopband barely moves, at 8 bits it climbs back to -32.8 dB. The spec signals.t27 designs the taps and computes both responses.

Try it

Switch between the three windows at 31 taps; then lower the coefficient bits until the bits, not the window, set the stopband.

+
Designing FIR taps: a window, a cutoff, and the bits you keepThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

Folding taps onto slices

+
+

You will learnHow symmetry and a fast clock cut the DSP slices a FIR needs.

A linear-phase FIR has symmetric taps, so the DSP48E1 pre-adder can add the two samples that share a tap and multiply once: 31 taps need 16 multipliers. A slice clocked C times per sample can run C of them one after another, so at 50 MHz on a 200 MHz clock 4 slices do the work, and at 48 kHz one slice does it all. The XC7A200T has 740 slices. The spec signals.t27 assigns every tap to its slice.

Try it

Compare 31 taps at 50 MHz with and without symmetry; then raise the sample rate until each slice serves one multiplier.

+
Folding a FIR onto DSP slicesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · Multirate

Lowering the sample rate without folding noise in: decimation, the CIC filter and the polyphase form.

+
+
19

Lesson 19 of 27

Lowering the rate

+
+

You will learnWhat keeping every R-th sample does to the spectrum, and which frequencies fold onto the band you keep.

Keep every R-th sample and the rate drops to fs/R, and every frequency near a multiple of the new rate lands near 0. Decimate 400 by 4 and a tone at 95 lands at 5, right inside a band of 10. The widget paints every input frequency that would fold onto the band: that is what the filter before the decimator has to remove, and why that filter can be cheap where nothing folds. The spec signals.t27 computes each fold.

Try it

With R = 4 and a band of 10, find the red zones and put a tone in each; then raise R and watch the zones multiply.

+
Decimation: lower the rate without folding noise inThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

The CIC filter

+
+

You will learnHow a CIC decimator filters with no multipliers, and how many bits its registers must grow.

A CIC decimator is N integrators at the input rate, a rate change of R and N combs with delay M at the output rate. Its DC gain is (RM)^N, so its registers grow ceil(N log2(RM)) bits: with N = 4, R = 8 and M = 1 that is 4096 and 12 bits, a 16-bit input in 28-bit registers. Its response has a null at every multiple of the output rate and droops 3.6 dB at a quarter of it. The spec signals.t27 computes the gain, the growth and the response.

Try it

Set one stage and compare the response with the moving average; then load the last preset and count the register bits.

+
The CIC filter: no multipliers, many bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

Polyphase

+
+

You will learnHow the polyphase form does the filtering of a decimator at the low rate.

Filtering at the input rate and throwing R - 1 of every R outputs away wastes R - 1 of every R multiplies. Deal the taps into R phases by k mod R instead: each phase is a short filter that only ever meets every R-th input, so all of them run at the output rate. A 31-tap decimate-by-4 filter falls from 124 MACs per output to 31. The spec signals.t27 computes the phases and the counts.

Try it

Find a tap count that splits evenly into 4 phases and one that does not; then compare the MACs at R = 8.

+
Polyphase: do the work at the low rateThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · The FFT

N log N instead of N^2: butterflies, the bit-reversed input order and the bits each stage adds.

+
+
22

Lesson 22 of 27

The butterfly

+
+

You will learnHow a radix-2 FFT breaks a DFT into stages of butterflies, and what that saves.

A butterfly takes a and b, multiplies b by a twiddle W and outputs a + Wb and a - Wb. A radix-2 FFT of N points is log2 N stages of N/2 of them: 3 stages of 4 butterflies at 8 points, 5120 butterflies at 1024 points against 1048576 multiplies for a direct DFT. The widget runs the integer FFT of the spec and shows every value: one cycle of cosine at 8 points comes out at 509 in bins 1 and 7. The spec signals.t27 computes every butterfly.

Try it

Light each stage of the 8-point FFT in turn and count the twiddles it uses; then find the stage where the value of the DC input doubles.

+
The FFT butterfly: N log N instead of N^2The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

Twiddles and bit reversal

+
+

You will learnWhy a decimation-in-time FFT takes its input in bit-reversed order, and where the twiddles come from.

Split the input into even and odd samples, then split each half again, and the order you end up reading them in is the index with its bits reversed. At 8 points, index 1 is 001 and goes to place 4, and 3 is 011 and goes to place 6. Reversing twice gives the index back, so the reordering is a set of swaps that needs no arithmetic, only wiring. The twiddles W are points on the unit circle, cos minus j sin. The spec signals.t27 computes both.

Try it

At 16 points find every index that stays in its place; then pick an index and read its twiddle.

+
Bit reversal: the order an FFT reads its input inThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

Growth through the stages

+
+

You will learnHow many bits the words of an FFT grow, and what halving every stage holds back and what it loses.

Every radix-2 stage can double a value, so an unscaled FFT grows up to log2 N bits, and the conservative width of the AMD FFT core is B + log2 N + 1. A full-scale DC input shows it plainly: 12 bits in, 16 bits out of a 16-point FFT, against the 17 of the rule. Halving every stage holds the word at 12 bits, but a spread signal loses a bit of precision at every stage. The spec signals.t27 runs the integer FFT the widget measures.

Try it

Run DC unscaled and halved; then run the noise input both ways and compare the largest output.

+
FFT word growth: how many bits each stage addsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · On the bench

From the arithmetic to the board: a correlator from the modem spec, a budget of slices and timing, and the capstone filter.

+
+
25

Lesson 25 of 27

A correlator finds the frame

+
+

You will learnHow a Barker-13 correlator finds the start of a frame, and how many flipped chips it survives.

A frame starts with the 13 chips of the Barker code, whose correlation with itself is 13 lined up and at most 1 shifted. The modem spec bpsk.t27 pushes each received chip into a 13-chip window and correlates it; it locks at 9, well between sidelobe and peak. The widget runs those very functions on a stream of 32 chips: the peak stands at 13 where the preamble lines up, an inverted carrier gives -13, and every flipped chip in the window lowers the peak by 2.

Try it

Flip two chips of the preamble and check that it still locks; then find how many flips stop the lock.

+
A correlator finds the frame: Barker-13 in a stream of chipsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/bpsk.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

Does it fit and close timing?

+
+

You will learnHow to budget DSP slices for a multichannel filter, and why the adder tree, not the multiplier, misses timing.

Sixteen channels of a 63-tap symmetric filter at 50 MHz on a 250 MHz clock take 7 slices each, 112 of the 740 on an XC7A200T. Whether it closes timing is a question about one register-to-register path: a direct adder tree puts ceil(log2 63) = 6 adders in it, a systolic chain through the slice cascade puts one. With the delays you set, the tree misses a 4000 ps period and the chain makes it. The spec signals.t27 counts; the timing report of your build measures.

Try it

Load the adder-tree preset, switch it to the systolic chain and read the slack; then find how many channels of the 127-tap filter fit.

+
Does it fit, and does it close timing?The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

Capstone: a filter on the board

+
+

You will learnHow the arithmetic of the course meets in one filter, computed bit for bit the way the board computes it.

Design the low-pass of lesson 17, feed it a passband tone and a stopband tone as 16-bit samples, and run it the way the RTL does: integer taps, a wide accumulator, round half up, saturate to 16 bits. With 31 Hamming taps of 16 bits the stopband tone is gone, the accumulator needs 32 bits, well inside the 48 of a DSP48E1, and the output stays within 1.5 LSB of the same filter in f64. To put it on the board, the chips below open the build receipt and the JTAG path.

Try it

Lower the coefficient bits to 8 and watch the error bars; then move the stopband tone into the passband and explain the output.

+
Capstone: a filter as the board computes itThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dsp/signals.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · Adding numbers
    1. 01 The carry chain
    2. 02 Looking ahead: prefix adders
    3. 03 Three numbers at once
  2. 02 · Multiplying
    1. 04 Shift and add
    2. 05 Booth's trick
    3. 06 The DSP48E1 slice
  3. 03 · Fixed point
    1. 07 Q formats
    2. 08 Rounding and saturation
    3. 09 Quantization noise
  4. 04 · Functions in hardware
    1. 10 Rotating by shifts
    2. 11 Angle and magnitude
    3. 12 Tables and interpolation
  5. 05 · Signals and sampling
    1. 13 Sampling and aliasing
    2. 14 A numerically controlled oscillator
    3. 15 Bins of a spectrum
  6. 06 · FIR filters
    1. 16 The moving average
    2. 17 Designing taps
    3. 18 Folding taps onto slices
  7. 07 · Multirate
    1. 19 Lowering the rate
    2. 20 The CIC filter
    3. 21 Polyphase
  8. 08 · The FFT
    1. 22 The butterfly
    2. 23 Twiddles and bit reversal
    3. 24 Growth through the stages
  9. 09 · On the bench
    1. 25 A correlator finds the frame
    2. 26 Does it fit and close timing?
    3. 27 Capstone: a filter on the board
+ + + + + diff --git a/apps/website/public/learn/arithmetic-and-dsp/index.html b/apps/website/public/learn/arithmetic-and-dsp/index.html index 31e3971a66..d3a8421e19 100644 --- a/apps/website/public/learn/arithmetic-and-dsp/index.html +++ b/apps/website/public/learn/arithmetic-and-dsp/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

Arithmetic and DSP on the FPGA: from the carry chain to a filter

It picks up where the buses course ends. Every widget in it runs the fn bodies of a t27 spec compiled to WebAssembly: move a slider and the spec answers.

Course 9, 27 lessons, a live widget and a t27 spec each: adders and carry chains, multipliers and the DSP48E1 slice, fixed point, CORDIC, sampling, FIR and CIC filters, the FFT, and a filter on the bench. Every number is computed by a compiled spec.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/arrays/index.html b/apps/website/public/learn/arrays/index.html index ec5d0db8c5..bc95bceeb7 100644 --- a/apps/website/public/learn/arrays/index.html +++ b/apps/website/public/learn/arrays/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Arrays

You will learn

How to declare an array, read an item, and which index is the last one.

An array type is the length in square brackets followed by the item type: [5]u8 is five unsigned bytes. The value lists the items in square brackets. Index 0 holds the item at the start, so in an array of 5 the last index is 4. A test reads an item with PRIMES[4]. Keep the declared length and the list in step: the checker in this browser does not catch a length that disagrees with the list.

Try it

Add a sixth prime to PRIMES, fix the length, and write an assert for index 5.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 7: an array and its indexes
t27 basics 7: an array and its indexes ↗

A t27 array drawn as a row of cells with their indexes, from the lesson spec. Lesson 7 of the t27 basics course.

specs/basics/07_arrays.t27

// SPDX-License-Identifier: Apache-2.0
@@ -82,6 +114,7 @@ 

Arrays

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/assertions/index.html b/apps/website/public/learn/assertions/index.html index 7963bbeaa7..d45e9ab50e 100644 --- a/apps/website/public/learn/assertions/index.html +++ b/apps/website/public/learn/assertions/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Assertions

You will learn

What an assertion is in code, and what it costs to check one every cycle.

An assertion is a check that stays in the design, every cycle, forever: not a testbench that runs once, but a sentence about the hardware that must hold while the hardware runs. The lesson's spec, formal, writes them as data -- immediate and concurrent, severities, clock and reset named -- because an assertion you cannot enumerate is an assertion you cannot discharge. The widget is the same idea at the door: each dependency the tool needs, present or not, checked in one call before anything runs.

Try it

Write one immediate and one concurrent assertion for a FIFO, with clock and reset named; then check the dependency widget for what tri itself assumes.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri selftest: the dependencies tri needs
tri selftest: the dependencies tri needs ↗

tri, railway, python3 and the loop directory: each present or not, in one call.

specs/fpga/formal.t27

// SPDX-License-Identifier: Apache-2.0
@@ -422,6 +454,7 @@ 

Assertions

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/attention/index.html b/apps/website/public/learn/attention/index.html index 404e9d3964..9b9694a432 100644 --- a/apps/website/public/learn/attention/index.html +++ b/apps/website/public/learn/attention/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Attention

You will learn

How attention scores every query against every key, what a softmax over each row gives, and what the causal mask removes.

Attention lets each position decide which other positions to read. Every query is scored against every key, q . k / sqrt(d), and a softmax turns each row of scores into weights that sum to 1; the output is the values averaged by those weights. Two heads do it on the two halves of the vector. With a causal mask a position cannot read the future: in head 0, position 0 reads only itself, position 1 splits 0.452 and 0.548, and position 2 spreads 0.230, 0.321 and 0.449. Without the mask every row spreads over all three keys, from 0.21 to 0.47. The spec attention_mechanism.t27 computes every weight on its own fixture.

Try it

Turn the mask off and on and read row 0; then compare the two heads on row 2.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Attention: how a word decides which other words to read
Attention: how a word decides which other words to read ↗

Two heads of attention over three positions: each row is how much one query reads each key. Switch on the causal mask and a position can no longer read the future.

specs/ml/recurrent/attention_mechanism.t27

// SPDX-License-Identifier: Apache-2.0
@@ -375,6 +407,7 @@ 

Attention

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/back-off/index.html b/apps/website/public/learn/back-off/index.html index f9b08c310f..6be8137670 100644 --- a/apps/website/public/learn/back-off/index.html +++ b/apps/website/public/learn/back-off/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Back off

You will learn

Why a row that answers wait is visited less and less often, and how often at least.

Over 44 minutes on 2026-10-09 the reviewer made 941 row visits, 888 of them wait, from 22 rows whose branch it could not read; one row was visited 54 times. revisit_after_seconds now waits 30 s after one wait and doubles per wait, never past 900 s: 30, 60, 120, 240, 480, 900. due_again lets the row be taken only once that time has passed, and any other answer resets the count.

Try it

Find the wait count where the pause stops growing; then set 4 waits and find the second the row is due.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Back off: when the reviewer looks at a waiting row again
Back off: when the reviewer looks at a waiting row again ↗

A row that answered wait is not visited again at once: 30 s, doubled per wait, never more than 900 s. Drag the waits and the clock and see when it is due.

specs/queen/reviewer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -383,6 +415,7 @@ 

Back off

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/back-to-three-values/index.html b/apps/website/public/learn/back-to-three-values/index.html index 099ec02a82..dcf0c30552 100644 --- a/apps/website/public/learn/back-to-three-values/index.html +++ b/apps/website/public/learn/back-to-three-values/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Back to three values

You will learn

How a threshold turns a neuron's sum back into a trit, and why each edge of the dead band needs its own test.

A neuron in a ternary network adds up products of trits, and the sum can be any small integer. quantize in activation_quantizer.t27 squeezes it back: above the threshold it returns 2 (P), below minus the threshold 0 (N), and in between 1 (Z). The on_comb at the end makes it combinational: no register, the output follows the inputs. The browser skips all 7 tests because its runner does not know assert_eq yet; the native t27c runs all 7, all pass, none vacuous. The recording changes > to >= on line 6, so a sum equal to the threshold already counts as P. Exactly one test fails, quantize_boundary_hi, which asks quantize(10, 10) for Z. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find quantize_boundary_lo and work out which one-character change on line 7 it would catch.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on activation_quantizer.t27 -- Quantize at the edge, native
t27c on activation_quantizer.t27 -- Quantize at the edge, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 7 tests pass natively; one > in the quantizer becoming >= fails exactly one test, quantize_boundary_hi; git restores the spec.

specs/ternary/activation_quantizer.t27

module ActivationQuantizer;
@@ -101,6 +133,7 @@ 

Back to three values

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/backpropagation/index.html b/apps/website/public/learn/backpropagation/index.html index 40d0d6dd43..67dd5f062d 100644 --- a/apps/website/public/learn/backpropagation/index.html +++ b/apps/website/public/learn/backpropagation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Backpropagation

You will learn

How the gradient of each weight and each input of a layer follows from the gradient of its outputs.

To learn, every weight needs to know how the loss changes when it moves. Backpropagation answers one layer at a time: given g, how much the loss wants each output to move, the weight from input i to output o gets g_o x_i, and input i gets the sum over o of W[o][i] g_o, which it hands on to the layer below. With inputs (1, 2, 3) and g = (1, 0.5) the weight gradients are 1, 2, 3 and 0.5, 1, 1.5, and the input gradients 0.5, 2 and 3.5. The layer is linear, so moving x0 by 1 moves the loss g . y from 15.25 to 15.75, by its gradient 0.5. The spec dense_layer.t27 computes all three.

Try it

Set g = (1, 0) and read which edges go dark; then set g = (-2, 1) and check the input gradients by hand.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Backpropagation: how blame flows back through a layer
Backpropagation: how blame flows back through a layer ↗

Set how much the loss wants each of two outputs to move: every weight gets that times its input, every input gets W transposed times it. The edges and nodes show the numbers.

specs/ml/layers/dense_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -282,6 +314,7 @@ 

Backpropagation

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/balanced-ternary/index.html b/apps/website/public/learn/balanced-ternary/index.html index 0540eb3887..e0c1569265 100644 --- a/apps/website/public/learn/balanced-ternary/index.html +++ b/apps/website/public/learn/balanced-ternary/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Balanced ternary

You will learn

How the digits -1, 0 and +1 write every integer, negative ones included, without a sign.

Balanced ternary weighs its places 1, 3, 9, 27 and lets each digit be -1, 0 or +1. Then 8 is 9 - 1 and -8 is -9 + 1: the sign lives in the digits. Six trits reach from -364 to +364, and every number in that range has exactly one form. The tiles under the counter are trit_at() of the spec, called once per place; one of its tests reads every number from -400 to 400 back from its trits.

Try it

Count up from -13 to 13 and watch which tile changes; find the number at which a fourth trit appears.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Balanced ternary: count with -1, 0 and +1
Balanced ternary: count with -1, 0 and +1 ↗

Step a number up and down and watch its trits change. Every integer, negative ones too, has one form with no sign symbol.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Balanced ternary

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/batch-normalisation/index.html b/apps/website/public/learn/batch-normalisation/index.html index 8f70b99f9e..6c4e71a11b 100644 --- a/apps/website/public/learn/batch-normalisation/index.html +++ b/apps/website/public/learn/batch-normalisation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Batch normalisation

You will learn

How batch norm puts features on different scales on one scale, and what it uses at inference.

Features on different scales pull a network around: in the spec's batch one feature is ten times another. Batch normalisation subtracts each feature's batch mean and divides by its spread, so the features 1, 2, 3, 4 and 10, 20, 30, 40 both come out as -1.34, -0.45, 0.45 and 1.34, and -1, -1, 1, 1 comes out as -1 and 1. A learned gamma and beta then scale and shift it back where that helps. At inference the layer uses running averages instead of the batch: with mean 0, variance 1, gamma 1 and beta 0.25, the inputs 1, 2 and 3 give 1.25, 2.25 and 3.25. The spec batchnorm_layer.t27 computes both.

Try it

Compare the two normalised columns; then set the running mean 2 and variance 4 and read the inference outputs.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Batch norm: features on very different scales, made comparable
Batch norm: features on very different scales, made comparable ↗

A batch of 4 samples whose 3 features live on scales 1, 10 and 1: batch norm gives each feature mean 0 and variance 1. Then set gamma and the running statistics for inference.

specs/ml/layers/batchnorm_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -273,6 +305,7 @@ 

Batch normalisation

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/baud-and-the-divisor/index.html b/apps/website/public/learn/baud-and-the-divisor/index.html index 74036a5541..ef1bd1aa2c 100644 --- a/apps/website/public/learn/baud-and-the-divisor/index.html +++ b/apps/website/public/learn/baud-and-the-divisor/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Baud and the divisor

You will learn

How one divisor turns a clock into a bit rate, and what changing it breaks.

The rate is a divisor: the clock divided by the baud gives the bit period, and the spec states it as a constant expression -- UART_BIT_PERIOD is UART_CLOCK_HZ / UART_BAUD_RATE, 100,000,000 over 115,200. The test uart_configure_changes_baud_divisor checks that configuring the driver moves the divisor. The recording shows the spec lowered to hardware IR: the compiler's own view of the wires and state before Verilog exists.

Try it

In the recording, watch the IR view of the divisor; then in the spec frame find UART_BIT_PERIOD and the test that moves it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c debug-hir on uart.t27 -- the bus as the compiler sees it
t27c debug-hir on uart.t27 -- the bus as the compiler sees it ↗

The UART spec lowered to hardware IR: the compiler's own view of the wires, ports and state before Verilog exists.

specs/fpga/uart.t27

// SPDX-License-Identifier: Apache-2.0
@@ -297,6 +329,7 @@ 

Baud and the divisor

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/bins-of-a-spectrum/index.html b/apps/website/public/learn/bins-of-a-spectrum/index.html index 80171b2bc5..91b54db4c8 100644 --- a/apps/website/public/learn/bins-of-a-spectrum/index.html +++ b/apps/website/public/learn/bins-of-a-spectrum/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Bins of a spectrum

You will learn

What one DFT bin measures, and why a tone between bins leaks into all of them.

A DFT of L points has L bins, each fs/L wide. A tone that fits a whole number of cycles in the window lands in one bin at 0 dB and nowhere else. Move it half a bin and the peak drops to -3.7 dB and leaks into every bin, because the DFT treats the window as one period of a repeat and the repeat jumps at the seam. A Hann window tapers the seam: at 8.5 bins on 64 points it lowers bin 20 from -33.2 dB to -73.9 dB. The spec signals.t27 computes every bin.

Try it

Slide the tone from 8 to 9 bins and watch the highest bin; then switch to Hann and compare a far bin.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Bins of a spectrum: one tone, and where it leaks
Bins of a spectrum: one tone, and where it leaks ↗

Slide a tone across the bins of a DFT. On a bin it is one clean bar; between bins it leaks everywhere, unless a window tapers the seam.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Bins of a spectrum

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/bits-and-trits/index.html b/apps/website/public/learn/bits-and-trits/index.html index d747323fa6..cb66c728cb 100644 --- a/apps/website/public/learn/bits-and-trits/index.html +++ b/apps/website/public/learn/bits-and-trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Bits, trits and GF16

You will learn

How a number is stored in bits, and how balanced ternary stores it in trits.

Hardware stores numbers as fixed groups of bits, and t27 makes you write the width: u8 is 8 unsigned bits, i16 is 16 signed bits. t27 also speaks balanced ternary, where a trit is -1, 0 or +1. For fractions it has GF16, a 16-bit float with 1 sign bit, 6 exponent bits and 9 mantissa bits. Type a number into the calculator and watch how it is rounded, field by field, and how big the error is.

Try it

Type 1.618 and read the exponent and mantissa bits; then type 0.1 and look at the error.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GF16 calculator: a number as 16 GoldenFloat bits and as ternary
GF16 calculator: a number as 16 GoldenFloat bits and as ternary ↗

Type a number and see its GF16 sign, exponent and mantissa bit by bit, the exact value it rounds to, the error, and the same number in balanced ternary.

specs/tutorial/01_values_and_types.t27

// SPDX-License-Identifier: Apache-2.0
@@ -138,6 +170,7 @@ 

Bits, trits and GF16

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/blocked-is-not-failed/index.html b/apps/website/public/learn/blocked-is-not-failed/index.html index 614039425c..d2dd9e5660 100644 --- a/apps/website/public/learn/blocked-is-not-failed/index.html +++ b/apps/website/public/learn/blocked-is-not-failed/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Blocked is not failed

You will learn

Why a rule checked while compiling stops a spec before any test runs, and how that differs from a failing test.

In the browser, setting MAX_TRITS to 3 made two checks fail. The native t27c is stricter: the 8 invariants of golden_sieve.t27 are proved while it compiles, so with a third trit the spec does not compile at all. The report says BLOCKED, and explains that a blocked spec never produced a binary, so it has no test results to count. A rule checked while compiling cannot ship broken. Then the recording plants a different bug: the rule against shift-register cells now always says yes, and exactly one test fails, the one that checks the formula. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find the line that says why a blocked spec has no test results, and the test the second bug breaks.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on golden_sieve.t27 -- the ternary sieve, native
t27c on golden_sieve.t27 -- the ternary sieve, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 3 tests pass natively; allowing a third trit trips a compile-time invariant and blocks the spec; letting S5 admit shift registers fails exactly one test; git restores the spec.

specs/numeric/golden_sieve.t27

// SPDX-License-Identifier: Apache-2.0
@@ -614,6 +646,7 @@ 

Blocked is not failed

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/board-selftest/index.html b/apps/website/public/learn/board-selftest/index.html index aee40e6ce0..46960ddf1f 100644 --- a/apps/website/public/learn/board-selftest/index.html +++ b/apps/website/public/learn/board-selftest/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The board self-tests

You will learn

How the bench checks itself: every script running its own self-test, nothing skipped.

The bench checks itself before it checks your design: 16 spec-named scripts run their own --self-test, 0 bad, and the 8 scripts that have no such flag are listed, not silently skipped -- the difference between 'all good' and 'all we measured'. The widget is that sweep. The lesson's spec is fpga-selftest, the inventory of what a self-test is. A bench that cannot say which of its tools are untested is a bench whose verdicts carry unknown error bars.

Try it

Open the self-test sweep and find the 8 scripts without a flag; then say what listing them, instead of skipping them, buys you.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-selftest: off-board self-tests, no port opened
tri fpga-selftest: off-board self-tests, no port opened ↗

16 spec-named scripts run their own --self-test, 0 bad; 8 without the flag are listed, not skipped silently.

specs/tools/trios/tri/fpga-selftest.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

The board self-tests

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/booths-trick/index.html b/apps/website/public/learn/booths-trick/index.html index bc13a87a07..8301d1b95c 100644 --- a/apps/website/public/learn/booths-trick/index.html +++ b/apps/website/public/learn/booths-trick/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Booth's trick

You will learn

How radix-4 Booth recoding turns eight rows into four and handles signed numbers with no special case.

Read the multiplier three bits at a time, overlapping by one, with an implicit 0 below bit 0. Each group becomes a digit from -2 to +2, and each digit one partial product: digit x a x 4^k. For 3 x 6 the digits of 6 are -2, +2, 0, 0, so the product is -6 + 24 = 18. The negative digits are what make two's complement work without a correction step. The spec checks the recoding against a x b for every pair of 8-bit numbers, all 65536 of them.

Try it

Load -128 x -128 and read the digits; then compare the Booth rows that add with the shift-and-add rows for b = 127.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Booth's trick: half the partial products, signs for free
Booth's trick: half the partial products, signs for free ↗

Set two signed numbers and watch the multiplier recoded into digits -2..+2, read three bits at a time. Four partial products instead of eight, and two's complement just works.

specs/fpga/dsp/multipliers.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

Booth's trick

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/bounded-model-checking/index.html b/apps/website/public/learn/bounded-model-checking/index.html index f40c45875a..63db53e682 100644 --- a/apps/website/public/learn/bounded-model-checking/index.html +++ b/apps/website/public/learn/bounded-model-checking/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Bounded model checking

You will learn

How a bounded search explores every input up to k cycles, and what that proves.

Bounded model checking is exhaustive search with a horizon: every input, every state, up to k cycles -- does any of them break the assertion? Inside the bound it is a proof, not a sample; no random seed can miss what the search enumerates. The lesson's spec carries the shape: a depth, a timeout, and properties to check. The widget is a bounded search in another domain: 84 board and model logs scanned for a key that must appear in none -- 0 hits, 0 logs too big to read -- absence, checked exhaustively rather than assumed.

Try it

Set a depth k and say exactly what your BMC run proves and does not; then find in the key sweep what '0 hits' took to be checkable rather than assumed.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-keycheck: the key is counted, never printed
tri fpga-keycheck: the key is counted, never printed ↗

84 board and model logs scanned for the TRI-NET key: 0 hits, 0 logs of 1 MB or more.

specs/fpga/formal.t27

// SPDX-License-Identifier: Apache-2.0
@@ -422,6 +454,7 @@ 

Bounded model checking

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/bring-up-on-the-bench/index.html b/apps/website/public/learn/bring-up-on-the-bench/index.html index 69d90bccff..4d83e67c96 100644 --- a/apps/website/public/learn/bring-up-on-the-bench/index.html +++ b/apps/website/public/learn/bring-up-on-the-bench/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Bring-up on the bench

You will learn

What a pre-registered bring-up looks like on the real bench, step by step.

A bring-up is not improvisation: the steps are pre-registered, each command is logged, and what did not run is as recorded as what did. The widget is the Ethernet bring-up plan on this bench, tri fpga-steps, and the spec is its tool card. The next module shows the discipline that guards the hardware the plan touches.

Try it

In the recording, count the steps and find one that did not run; then in the spec frame read what the tool card declares it records.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-steps E3
tri fpga-steps E3 ↗

The Ethernet bring-up plan on the bench: pre-registered steps, logged exits, what ran and what did not

specs/tools/trios/tri/fpga-steps.t27

// SPDX-License-Identifier: Apache-2.0
@@ -107,6 +139,7 @@ 

Bring-up on the bench

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/bugs-that-compile/index.html b/apps/website/public/learn/bugs-that-compile/index.html index e2489eaf62..f489bff709 100644 --- a/apps/website/public/learn/bugs-that-compile/index.html +++ b/apps/website/public/learn/bugs-that-compile/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Bugs that compile

You will learn

Why a clean compile proves so little, and what a seal without output is worth.

Everything here compiles. The UART testbench in the player is green on all seven backends, and it still proves almost nothing: a compile says the words parse and the types line up, not that the words are the ones you meant. The widget shows the bigger trap. Every merged spec in t27 carries a seal, a hash of what building it produced; 31 of 1,428 seals record no output at all, spread over 16 specs, and 3 of those are missing from the debt ledger that is supposed to name them. A seal with no output behind it is a green check with nothing under it -- verification begins exactly there.

Try it

Open the seal sweep and find the 16 specs with no output; then open uart_tb in the player and say out loud what a compile of it does not prove.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri seals: hollow seals that pass every check
tri seals: hollow seals that pass every check ↗

31 of 1,428 seals record no output (16 specs); 3 of those are missing from the debt ledger.

specs/fpga/testbench/uart_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -464,6 +496,7 @@ 

Bugs that compile

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/build-verify/index.html b/apps/website/public/learn/build-verify/index.html index 4d2337e333..f42b2aa718 100644 --- a/apps/website/public/learn/build-verify/index.html +++ b/apps/website/public/learn/build-verify/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Build and verify

You will learn

How one command re-runs every sweep and turns a build into a verdict.

A build is not a verdict until one command can re-derive it. The widget is that command for the bitstream stack: CRC 12/12 over the references, ECC 32520/32520 frames, 82/82 pins, 4224/4224 segbits, gold 5/5 -- every sweep re-run, every count with its denominator, and the last line says audit: CLEAN. The lesson's spec, build_verify, is the same list as a spec. If a person has to remember to run the checks, the checks will someday not be run.

Try it

Run the audit and find the one count with the largest denominator; then read build_verify and mark which checks are re-derived, not remembered.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri x7-audit · the whole bitstream path, re-checked
tri x7-audit · the whole bitstream path, re-checked ↗

One command re-runs every sweep: CRC 12/12 over 6 reference bitstreams, ECC 32520/32520 frames, FAR walk = Vivado FDRI, 82/82 pins, 4224/4224 segbits, writer 16/16 and fasm 22/22 byte-identical to xc7frames2bit and fasm2frames, gold 5/5. audit: CLEAN.

specs/fpga/verification/build_verify.t27

// SPDX-License-Identifier: Apache-2.0
@@ -191,6 +223,7 @@ 

Build and verify

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/bursts-and-ids/index.html b/apps/website/public/learn/bursts-and-ids/index.html index db3fc8f5c7..9844a7d277 100644 --- a/apps/website/public/learn/bursts-and-ids/index.html +++ b/apps/website/public/learn/bursts-and-ids/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Bursts and IDs

You will learn

How a burst is described, what an ID is for, and what the AXI4 bench checks.

A burst is one address and a count: AXI_LEN_WIDTH 8 means up to 256 beats under one address, and the ID lets a master's transactions interleave and still land in order. The bench drives it: test_reset_state, test_single_write, test_single_read, test_write_read_roundtrip, test_multiple_writes, eight tests. The recording lowers the AXI4 testbench spec to Verilog.

Try it

In the recording, find the bench tests; then in the spec frame compute the burst ceiling the LEN width allows and say what an ID buys.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on axi4_tb.t27 -- the testbench as RTL
t27c gen-verilog on axi4_tb.t27 -- the testbench as RTL ↗

The AXI4 testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/axi4_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -278,6 +310,7 @@ 

Bursts and IDs

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/buses-and-peripherals/all/card.png b/apps/website/public/learn/buses-and-peripherals/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..fa58daecb8083d09d0fbb1b6b3d1dd8ea776d2b1 GIT binary patch literal 39809 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 literal 0 HcmV?d00001 diff --git a/apps/website/public/learn/buses-and-peripherals/all/index.html b/apps/website/public/learn/buses-and-peripherals/all/index.html new file mode 100644 index 0000000000..4ca659feae --- /dev/null +++ b/apps/website/public/learn/buses-and-peripherals/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Buses and peripherals with t27: UART, SPI, APB, AXI4, Ethernet: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

Buses and peripherals with t27: UART, SPI, APB, AXI4, Ethernet

+

It picks up where the clocks course ends. Every lesson opens a real tool or a recording of t27c on a real machine, next to a spec you can run in your browser.

+

Course 7, 27 lessons, one widget and one t27 spec each: why a bus exists, the UART frame, SPI modes, the APB handshake, the five AXI4 channels, memory maps, bridges, Ethernet frames and RGMII timing, and the bench IO discipline. Every number comes from a spec or a recorded run.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · What a bus is

Why a bus exists at all: a conversation on wires, framed and addressed, and who is allowed to talk.

+
+
01

Lesson 1 of 27

Wires that talk

+
+

You will learnWhat a bus is for, what the two-wire conversation of a UART costs, and what the course's opening spec checks.

A bus exists because pins are dear: two chips that must talk share wires, and the wires carry a conversation both sides agreed to. The simplest one is the UART of this lesson's spec, ZeroDSP_UART: two wires, no clock, both sides agreeing on a rate -- the spec carries UART_CLOCK_HZ at 100,000,000 and UART_BAUD_RATE at 115,200. The recording runs t27c check on the spec: 0 errors, 0 warnings, the entry bar every lesson's spec clears. The player compiles it in your browser.

Try it

In the recording, find the error and warning counts; then in the spec frame find UART_CLOCK_HZ and UART_BAUD_RATE and divide them for the bit period.

+
t27c check on uart.t27 -- the spec compilesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/uart.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

Framing a conversation

+
+

You will learnWhat a clocked conversation changes, and how the SPI spec states its modes and rates.

A conversation needs rules about when a word starts and ends, or the far side samples noise. The clocked answer is SPI, and the spec of this lesson, SPI_Master, states its ground: CLK_FREQ at 50,000,000, SPI_CPOL and SPI_CPHA at 0, a maximum data width of 32 bits. The recording runs t27c check on it: 0 errors, 0 warnings. The three buses this module opens -- UART, SPI, APB -- are the three answers the course takes apart, one per module.

Try it

In the recording, find the error and warning counts; then in the spec frame find CLK_FREQ, CPOL and CPHA, and say which mode the spec configures.

+
t27c check on spi.t27 -- the spec compilesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/spi.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

Master and servant

+
+

You will learnWhat a register bus is, who drives and who answers, and how APB names the roles.

A register bus gives the conversation roles: one master drives addresses, each servant answers when named. APB is that bus at its plainest, and the spec of this lesson is its bridge: ApbBridge, with APB_ADDR_WIDTH 32, APB_DATA_WIDTH 32 and APB_STRB_WIDTH 4. The recording runs t27c check: 0 errors, 0 warnings. The module after next takes its handshake apart phase by phase.

Try it

In the recording, find the error and warning counts; then in the spec frame find the three APB widths and say what the strobe width of 4 covers.

+
t27c check on apb_bridge.t27 -- the spec compilesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/apb_bridge.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · UART

The two-wire bus with no clock: the frame, the divisor that sets the rate, and the status a driver polls.

+
+
04

Lesson 4 of 27

The frame: start, data, stop

+
+

You will learnHow a UART frame is built bit by bit, and what the compiler emits for it.

A UART frame is the atoms of the bus: the line idles high, a start bit pulls it low, eight data bits follow, and a stop bit returns it high. The testbench spec of the last lesson of this module checks the idle itself -- uart_tb_tx_idle_high and uart_tb_rx_idle_high are two of its seven tests. The recording shows the compiler lowering the spec to synthesizable Verilog: the module ZeroDSP_UART, its clk, rst_n, en, data and ready ports, the datapath as wires.

Try it

In the recording, find the module name and its ports; then in the spec frame find the width and depth constants of the frame and the FIFO.

+
t27c gen-verilog on uart.t27 -- spec to RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/uart.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

Baud and the divisor

+
+

You will learnHow one divisor turns a clock into a bit rate, and what changing it breaks.

The rate is a divisor: the clock divided by the baud gives the bit period, and the spec states it as a constant expression -- UART_BIT_PERIOD is UART_CLOCK_HZ / UART_BAUD_RATE, 100,000,000 over 115,200. The test uart_configure_changes_baud_divisor checks that configuring the driver moves the divisor. The recording shows the spec lowered to hardware IR: the compiler's own view of the wires and state before Verilog exists.

Try it

In the recording, watch the IR view of the divisor; then in the spec frame find UART_BIT_PERIOD and the test that moves it.

+
t27c debug-hir on uart.t27 -- the bus as the compiler sees itThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/uart.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

Status and FIFOs

+
+

You will learnWhat a driver polls, when a send is refused, and what the testbench of the UART checks.

A driver needs to know the hardware's mood: the spec carries STATUS_IDLE as 0, STATUS_TX_BUSY as 1, STATUS_RX_BUSY as 2, and a 16-deep FIFO each way. The test uart_tx_send_returns_false_when_busy is the rule a driver lives by -- you do not push a busy transmitter. The recording lowers the UART testbench spec to Verilog: what a bench looks like when the compiler emits it.

Try it

In the recording, find what the bench prints of the idle lines; then in the spec frame find the three status codes and the test that refuses a busy send.

+
t27c gen-verilog on uart_tb.t27 -- the testbench as RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/uart_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · SPI

The clocked conversation: four modes, a prescaler ladder, and a chip select per servant.

+
+
07

Lesson 7 of 27

Modes: CPOL and CPHA

+
+

You will learnWhat CPOL and CPHA mean, why there are four modes, and which one the spec configures.

CPOL picks the clock's idle level, CPHA picks which edge samples: four combinations, four modes, and devices that only speak one. The spec configures mode 0 -- SPI_CPOL 0, SPI_CPHA 0 -- and spi_mode_0_configuration is the test that pins it. The recording lowers the SPI spec to synthesizable Verilog.

Try it

In the recording, find the module ports the Verilog gives the SPI master; then in the spec frame find the mode-0 test and name what CPOL and CPHA each pick.

+
t27c gen-verilog on spi.t27 -- spec to RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/spi.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

The prescaler ladder

+
+

You will learnHow the prescaler ladder turns one clock into a family of SCK rates, and which steps are valid.

One clock becomes a family of rates through the prescaler ladder: PRESCALER_2 is 0, PRESCALER_4 is 1, and the ladder climbs while the clock holds. spi_prescaler_16_default checks the default, spi_set_prescaler_valid and spi_set_prescaler_invalid check the bounds, spi_sck_freq_at_50 checks the arithmetic. The recording is a native run: the SPI testbench spec through the real t27c, 7 tests pass.

Try it

In the recording, count the passing tests; then in the spec frame list the prescaler constants and find the test that checks the default.

+
t27c on spi_tb.t27 -- simulating the SPI testbenchThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/spi_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Chip select and widths

+
+

You will learnHow a chip select picks the listener, and how wide a transfer may be.

The chip select is the addressing of SPI: pull one CS low and that servant listens, hold the others high and they stay silent. The spec gives the select its timing -- CS_ASSERT_DELAY and CS_DEASSERT_DELAY at 100 ns each -- and the width its bounds: spi_set_data_width_8 and spi_set_data_width_32 bracket a MAX_DATA_WIDTH of 32. The recording lowers the SPI testbench spec to Verilog.

Try it

In the recording, find the bench's Verilog; then in the spec frame find both CS delays and the two width tests that bracket the maximum.

+
t27c gen-verilog on spi_tb.t27 -- the testbench as RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/spi_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · APB

The register bus: PSEL and PENABLE, strobes and wait states, and how many address bits a peripheral count costs.

+
+
10

Lesson 10 of 27

PSEL and PENABLE

+
+

You will learnHow the APB two-phase handshake works, and what the compiler emits for the bridge.

APB moves a transfer in two phases: setup, where PSEL names the servant and the address settles, and access, where PENABLE rises and the transfer completes. The spec's ApbTransfer enum carries the kinds, and the bench of the twelfth lesson drives write and read through them. The recording lowers the APB bridge spec to synthesizable Verilog: the port list, the wiring, the decode.

Try it

In the recording, find the bridge's port list; then in the spec frame find the ApbTransfer kinds and say which phase PENABLE names.

+
t27c gen-verilog on apb_bridge.t27 -- spec to RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/apb_bridge.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

Strobes and waits

+
+

You will learnWhat the strobe bytes mean, when a servant holds the bus, and how the IR sees it.

The strobe bytes say which lanes of the word carry data: strb_width_32bit and strb_width_16bit are two of the spec's eighteen tests, one word served whole and one half-word served. A slow servant holds the bus with a wait state instead of guessing. The recording shows the APB bridge as hardware IR: PSEL, PENABLE and the decode as the compiler structures them.

Try it

In the recording, find PSEL and PENABLE in the IR; then in the spec frame find the two strobe-width tests and say what a half-word transfer strobes.

+
t27c debug-hir on apb_bridge.t27 -- the handshake as IRThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/apb_bridge.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

Address decode

+
+

You will learnHow many address bits a peripheral count costs, and what the bench of the bridge checks.

Addressing on APB is a question of bits: how many servants sit behind the bridge decides how many address bits the decode spends. The spec answers by count -- addr_bits_for_1_peripheral, addr_bits_for_4_peripherals, addr_bits_for_8_peripherals -- and its testbench drives the result: test_reset_state, test_apb_write, test_apb_read, test_write_read_roundtrip, test_multiple_apb_writes, eight tests. The recording lowers the APB bridge testbench spec to Verilog.

Try it

In the recording, find the bench tests; then in the spec frame compute the address bits the spec spends for 8 peripherals.

+
t27c gen-verilog on apb_bridge_tb.t27 -- the testbench as RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/apb_bridge_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · AXI4

The five channels: address, data and response in both directions, lite or full, bursts and IDs.

+
+
13

Lesson 13 of 27

Five channels

+
+

You will learnWhat the five AXI4 channels carry, and what the compiler emits for them.

AXI4 carries five independent channels: write address, write data, write response, read address, read data. The spec states the widths -- AXI_ADDR_WIDTH 32, AXI_DATA_WIDTH 32, AXI_STRB_WIDTH 4, AXI_ID_WIDTH 4, AXI_LEN_WIDTH 8, AXI_SIZE_WIDTH 3 -- under a MAX_BUS_PORTS of 32. The recording lowers the AXI4 spec to synthesizable Verilog: the channels' wiring and handshakes as generated wires.

Try it

In the recording, find the channels in the emitted wires; then in the spec frame list the six AXI widths and say what the 8-bit LEN covers.

+
t27c gen-verilog on axi4.t27 -- spec to RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/axi4.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Lite or full

+
+

You will learnWhat AXI4 Lite keeps and drops, and what validation demands of a bus.

Lite is the same handshake with the burst machinery lifted out: no LEN, no size ladder, one transfer at a time. The spec's AxiKind enum carries lite and full, and its tests name the difference -- axi4_lite_is_lite, axi4_full_is_full -- and the validation rules: validate_lite_ok, validate_full_ok, validate_empty_name, validate_zero_addr. The recording runs t27c check on the spec: 0 errors, 0 warnings.

Try it

In the recording, find the error and warning counts; then in the spec frame find the AxiKind values and the four validation tests.

+
t27c check on axi4.t27 -- the spec compilesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/axi4.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

Bursts and IDs

+
+

You will learnHow a burst is described, what an ID is for, and what the AXI4 bench checks.

A burst is one address and a count: AXI_LEN_WIDTH 8 means up to 256 beats under one address, and the ID lets a master's transactions interleave and still land in order. The bench drives it: test_reset_state, test_single_write, test_single_read, test_write_read_roundtrip, test_multiple_writes, eight tests. The recording lowers the AXI4 testbench spec to Verilog.

Try it

In the recording, find the bench tests; then in the spec frame compute the burst ceiling the LEN width allows and say what an ID buys.

+
t27c gen-verilog on axi4_tb.t27 -- the testbench as RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/axi4_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · Memory

What sits on the far side of every bus: memory maps, port kinds, and latency that a wait state must cover.

+
+
16

Lesson 16 of 27

Memory maps

+
+

You will learnHow a memory map is declared, what BRAM and ROM mean as kinds, and what 15 native tests check.

A memory map is who lives at which address: the spec's MemKind enum carries the kinds, and make_bram_has_depth, make_bram_small and make_bram_single are three of its fifteen tests. The recording is a native run: the memory spec through the real t27c, 15 tests pass and 6 invariants are proved comptime -- the one spec of the bus family the native runner takes whole.

Try it

In the recording, count the passing tests and proved invariants; then in the spec frame find the MemKind values and the three make_bram tests.

+
t27c on memory.t27 -- the memory map, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/memory.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

Ports and kinds

+
+

You will learnWhat a port is on a memory, how many a memory may have, and who may write.

A port is a lane into the memory: read, write or both, and MAX_MEM_PORTS 8 bounds them. add_read_port_increments, add_write_port_increments and add_rw_port check the counting, is_rom checks that a read-only kind refuses a write port. The recording runs t27c check on the spec: 0 errors, 0 warnings.

Try it

In the recording, find the error and warning counts; then in the spec frame find MAX_MEM_PORTS and the test that refuses a write port on ROM.

+
t27c check on memory.t27 -- the spec compilesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/memory.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

Latency

+
+

You will learnWhat latency a memory answers in, and what the memory bench checks of reads and writes.

Every answer costs cycles, and the spec's MemLatency enum carries the kinds a wait state must cover. The bench checks the behaviour: test_reset_clears, test_write_read_single, test_write_read_multiple, test_overwrite, test_all_zero_bits, nine tests. The recording lowers the memory testbench spec to Verilog.

Try it

In the recording, find the bench tests; then in the spec frame find the MemLatency kinds and say what a wait state must cover.

+
t27c gen-verilog on memory_tb.t27 -- the testbench as RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/memory_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · Bridges

Why designs grow more than one bus, and the packet bridge that moves work between them.

+
+
19

Lesson 19 of 27

Why bridges

+
+

You will learnWhy a design grows more than one bus, and what the bridge spec checks of its own state.

A design grows more than one bus because peripherals andcompute differ: a slow register bus for the knobs, a wide one for the data. The bridge spec, FPGA_Bridge, is the crossing of this design, and bridge_initially_idle and bridge_rx_buffers_empty are two of its twenty-one tests. The recording runs t27c check: 0 errors, 0 warnings.

Try it

In the recording, find the error and warning counts; then in the spec frame find the two idle tests and count the spec's tests.

+
t27c check on bridge.t27 -- the spec compilesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/bridge.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

The packet bridge

+
+

You will learnHow the packet bridge moves work between buses, and what its buffers cost.

The packet bridge moves work between buses as packets: RX and TX buffers of 256 bytes each, an SPI buffer of 64, MAX_PACKET_SIZE 128, PACKET_TIMEOUT 10,000 cycles, and opcodes OP_MAC_MUL, OP_MAC_MAC and OP_MAC_MACC for the work it carries. bridge_buffer_count_wrap and bridge_buffer_count_wrap2 check the arithmetic at the seam. The recording lowers the bridge spec to synthesizable Verilog.

Try it

In the recording, find the module ports of the bridge; then in the spec frame find the four buffer constants and the timeout, and the three opcodes.

+
t27c gen-verilog on bridge.t27 -- spec to RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/bridge.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

Everything in one bench

+
+

You will learnWhat an integration bench checks when every bus of the design is driven at once.

An integration bench drives every bus at once and asks the design to hold together: test_reset_all_modules, test_module_count, test_mac_uart_pipeline, test_spi_memory_pipeline, test_full_pipeline, seven tests. The recording lowers the integration testbench spec to Verilog: every bus of the design in one bench.

Try it

In the recording, find the five pipeline tests; then in the spec frame say which two buses the integration bench joins.

+
t27c gen-verilog on integration_tb.t27 -- the integration benchThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/integration_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · Ethernet

Frames, the frame check sequence, RGMII timing, and the pre-registered steps of a real bring-up.

+
+
22

Lesson 22 of 27

Frames and the FCS

+
+

You will learnHow an Ethernet frame ends in a CRC-32, and what the check computes.

An Ethernet frame ends in a frame check sequence: a CRC-32 over the bytes, computed by the sender and recomputed by the receiver. The spec of this lesson, written for this course, carries the polynomial and the arithmetic, and its header labels what the check does and does not claim. The recording runs t27c on it.

Try it

In the recording, watch the run; then in the spec frame find the polynomial the CRC-32 uses and what the header labels as an assumption.

+
t27c on eth_crc.t27 -- the FCS, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/eth_crc.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

RGMII timing

+
+

You will learnWhat RGMII timing demands of a double-data-rate nibble, and what the spec asserts of it.

RGMII moves a nibble per clock edge, both edges: double data rate at 125 MHz for gigabit, and a single-data-rate downshift for 10 and 100. The spec of this lesson, written for this course, carries the timing arithmetic and its assumptions in the header. The recording runs t27c on it.

Try it

In the recording, watch the run; then in the spec frame find the DDR rate and what the spec says of the 10 and 100 downshift.

+
t27c on rgmii.t27 -- RGMII timing, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/rgmii.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

Bring-up on the bench

+
+

You will learnWhat a pre-registered bring-up looks like on the real bench, step by step.

A bring-up is not improvisation: the steps are pre-registered, each command is logged, and what did not run is as recorded as what did. The widget is the Ethernet bring-up plan on this bench, tri fpga-steps, and the spec is its tool card. The next module shows the discipline that guards the hardware the plan touches.

Try it

In the recording, count the steps and find one that did not run; then in the spec frame read what the tool card declares it records.

+
tri fpga-steps E3The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/fpga-steps.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · The bench

The discipline that guards real hardware: who holds the IO, taking and giving the lock, and what runs next.

+
+
25

Lesson 25 of 27

Who holds the IO

+
+

You will learnWho holds the bench IO right now, and what the registered clients declare.

Real hardware shared is hardware borrowed: the bench registers its IO clients, and the recording reads them live -- names, claims and what each declares it owns. The spec is the tool card of tri fpga-ioclients. The lesson closes the loop the course opened: a bus, its spec, its bench, and now the hands on it.

Try it

In the recording, list the clients the bench reports; then in the spec frame find what a client must declare to register.

+
tri fpga-ioclients -- who holds the bench IOThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/fpga-ioclients.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

Claim and release

+
+

You will learnHow a claim is taken and given back, and why the discipline matters.

A claim is a promise: one client holds the lock, works, and gives it back. The recording takes the claim with tri fpga-claim and the chip that follows it gives it back with tri fpga-release -- take and return recorded back to back, the bench reporting who holds it and then itself free. The spec is the tool card of tri fpga-claim.

Try it

In the recording, watch the claim land and the release land; then in the spec frame find what tri fpga-claim refuses when the lock is held.

+
tri fpga-claim -- taking the bench lockThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/fpga-claim.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

Capstone: what runs next

+
+

You will learnHow the pieces of this course meet in one design, and what runs next on the bench.

Close the course where it started, at the whole design: top_level.t27 carries CLK_FREQ_HZ 100,000,000, SYSTICK_HZ 1000, NUM_MAC_UNITS 8, DATA_WIDTH 32, and the opcodes CMD_NOP, CMD_MAC_MULT, CMD_MAC_DOT and CMD_UART_SEND -- nineteen tests of the design that holds every bus this course took apart. The recording reads what the bench runs next; the also-chips lower the whole design to Verilog, and its top bench with it.

Try it

In the recording, read what runs next; then in the spec frame find the four opcodes and count the design's tests.

+
tri fpga-next -- what the bench wants nextThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/top_level.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · What a bus is
    1. 01 Wires that talk
    2. 02 Framing a conversation
    3. 03 Master and servant
  2. 02 · UART
    1. 04 The frame: start, data, stop
    2. 05 Baud and the divisor
    3. 06 Status and FIFOs
  3. 03 · SPI
    1. 07 Modes: CPOL and CPHA
    2. 08 The prescaler ladder
    3. 09 Chip select and widths
  4. 04 · APB
    1. 10 PSEL and PENABLE
    2. 11 Strobes and waits
    3. 12 Address decode
  5. 05 · AXI4
    1. 13 Five channels
    2. 14 Lite or full
    3. 15 Bursts and IDs
  6. 06 · Memory
    1. 16 Memory maps
    2. 17 Ports and kinds
    3. 18 Latency
  7. 07 · Bridges
    1. 19 Why bridges
    2. 20 The packet bridge
    3. 21 Everything in one bench
  8. 08 · Ethernet
    1. 22 Frames and the FCS
    2. 23 RGMII timing
    3. 24 Bring-up on the bench
  9. 09 · The bench
    1. 25 Who holds the IO
    2. 26 Claim and release
    3. 27 Capstone: what runs next
+ + + + + diff --git a/apps/website/public/learn/buses-and-peripherals/index.html b/apps/website/public/learn/buses-and-peripherals/index.html index bd54c5ba5f..b3f9f99555 100644 --- a/apps/website/public/learn/buses-and-peripherals/index.html +++ b/apps/website/public/learn/buses-and-peripherals/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

Buses and peripherals with t27: UART, SPI, APB, AXI4, Ethernet

It picks up where the clocks course ends. Every lesson opens a real tool or a recording of t27c on a real machine, next to a spec you can run in your browser.

Course 7, 27 lessons, one widget and one t27 spec each: why a bus exists, the UART frame, SPI modes, the APB handshake, the five AXI4 channels, memory maps, bridges, Ethernet frames and RGMII timing, and the bench IO discipline. Every number comes from a spec or a recorded run.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/capstone-a-filter-on-the-board/index.html b/apps/website/public/learn/capstone-a-filter-on-the-board/index.html index 7e62566561..19ae478ba5 100644 --- a/apps/website/public/learn/capstone-a-filter-on-the-board/index.html +++ b/apps/website/public/learn/capstone-a-filter-on-the-board/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Capstone: a filter on the board

You will learn

How the arithmetic of the course meets in one filter, computed bit for bit the way the board computes it.

Design the low-pass of lesson 17, feed it a passband tone and a stopband tone as 16-bit samples, and run it the way the RTL does: integer taps, a wide accumulator, round half up, saturate to 16 bits. With 31 Hamming taps of 16 bits the stopband tone is gone, the accumulator needs 32 bits, well inside the 48 of a DSP48E1, and the output stays within 1.5 LSB of the same filter in f64. To put it on the board, the chips below open the build receipt and the JTAG path.

Try it

Lower the coefficient bits to 8 and watch the error bars; then move the stopband tone into the passband and explain the output.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Capstone: a filter as the board computes it
Capstone: a filter as the board computes it ↗

Design a low-pass, feed it two tones as 16-bit samples and see what the RTL arithmetic outputs next to the same filter in f64, down to the last bit.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Capstone: a filter on the board

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/capstone-diff/index.html b/apps/website/public/learn/capstone-diff/index.html index ac96a7049d..7447e375b7 100644 --- a/apps/website/public/learn/capstone-diff/index.html +++ b/apps/website/public/learn/capstone-diff/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Capstone: change it and diff it

You will learn

How the pieces of this course meet in one build, and what a bitstream diff says about a change.

Close the loop: change one thing about a crossing -- a synchronizer stage, a Gray pointer, a constraint -- rebuild, and ask the bitstream what moved. The widget compares two Xilinx 7-series bitstreams in your browser: header, packets, and every 101-word frame, with the differing frame address decoded; nothing is uploaded. A CDC change that claims to change nothing should diff to nothing, and one that means something shows exactly which frames it touched. The spec frame opens fifo.t27, the buffer this course built crossing by crossing, and its 18 passing tests are the receipt.

Try it

In the widget, drop two bitstreams if you have them and find the differing frame; then in the spec frame pick one test of the FIFO and say what change would break it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri blog list: every t27.ai post and its receipt state
tri blog list: every t27.ai post and its receipt state ↗

73 published posts with date, language and revision, newest first.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Capstone: change it and diff it

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/capstone-what-runs-next/index.html b/apps/website/public/learn/capstone-what-runs-next/index.html index 116ab93c9f..823df56914 100644 --- a/apps/website/public/learn/capstone-what-runs-next/index.html +++ b/apps/website/public/learn/capstone-what-runs-next/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Capstone: what runs next

You will learn

How the pieces of this course meet in one design, and what runs next on the bench.

Close the course where it started, at the whole design: top_level.t27 carries CLK_FREQ_HZ 100,000,000, SYSTICK_HZ 1000, NUM_MAC_UNITS 8, DATA_WIDTH 32, and the opcodes CMD_NOP, CMD_MAC_MULT, CMD_MAC_DOT and CMD_UART_SEND -- nineteen tests of the design that holds every bus this course took apart. The recording reads what the bench runs next; the also-chips lower the whole design to Verilog, and its top bench with it.

Try it

In the recording, read what runs next; then in the spec frame find the four opcodes and count the design's tests.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-next -- what the bench wants next
tri fpga-next -- what the bench wants next ↗

The next queued step on the bench, read live from the run state.

specs/fpga/top_level.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

Capstone: what runs next

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/capstone/index.html b/apps/website/public/learn/capstone/index.html index 17ee528cd2..319446f7b3 100644 --- a/apps/website/public/learn/capstone/index.html +++ b/apps/website/public/learn/capstone/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Capstone: out-guess yosys

You will learn

Put it together: guess what a real t27 module costs in LUTs.

Everything from this course in one game. Each day Gatle shows one real t27 module and the Verilog your browser compiles from it; you have six guesses at how many LUTs yosys spent on it. Use what you know: widths, multipliers, hierarchy, state. Then look at the other ways people and agents compete on t27.

Try it

Play today's puzzle. Then read the module's Verilog and say why it cost what it did. Run the tests in the spec frame: how many of the 12 instructions in hello_kernel are GF16 operations, and which test says all 12 take 48 bytes?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Gatle: guess how many LUTs yosys spends on today's t27 module
Gatle: guess how many LUTs yosys spends on today's t27 module ↗

A daily guessing game: one real t27 module, its Verilog compiled in your browser, six guesses at the LUT count yosys reported for it.

specs/fpga/e2e_demo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -320,6 +352,7 @@ 

Capstone: out-guess yosys

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/capture-a-crossing/index.html b/apps/website/public/learn/capture-a-crossing/index.html index 61d9bb8b4d..a143b5047a 100644 --- a/apps/website/public/learn/capture-a-crossing/index.html +++ b/apps/website/public/learn/capture-a-crossing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Capture a crossing

You will learn

How one crossing was captured at the flip-flops on a real board, and what the recorded run printed.

One crossing, captured where it lands: at the RX flip-flops themselves. The tri fpga-rxcap command models the E3 RX capture on the AX7203 board (XC7A200T in an FBG484 package) in the same SDF the last module used, and its recorded run printed: falling-edge hold 10900 ps on rxctl_n, with RXC 2.4 ns behind its data through the BUFG, so rxd_p1 and an RX_ER nibble sample the new value over a window the model states. The spec is a tool card -- constants for a tool page, 0 tests, and the recording shows the native report saying exactly that. The pins it captures are the far end of every lesson before this one.

Try it

In the recording, find the recorded hold margin and the delay through the BUFG; then in the spec frame read the tool card's data sources and say what the model did not measure.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on fpga-rxcap.t27 -- the RX capture card, native
t27c on fpga-rxcap.t27 -- the RX capture card, native ↗

The tri fpga-rxcap tool-card spec reports 0 tests -- constants for a tool page, not a test suite; the first lines show what it carries.

specs/tools/trios/tri/fpga-rxcap.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Capture a crossing

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/cards.json b/apps/website/public/learn/cards.json index d09ece2dd2..e38492d520 100644 --- a/apps/website/public/learn/cards.json +++ b/apps/website/public/learn/cards.json @@ -28,11 +28,14 @@ "learn/address-decode/": "4b7a49117662ffbd5cfbfb3948b4cd5147f03db14d243842f24259f7b770acbe", "learn/aging-a-label/": "45a56a1b4082cb5d49027c806b19a5d17f821c426825db816c8d9cdd20e8e98f", "learn/ai-numbers/": "d9f22ce61d2271479c53486b027260f1c4713f13dc09d0acbdb20446d40d0f3a", + "learn/ai-numbers/all/": "d6c322f9bb46048bbfd365969783f09dd56b9da63d649f2c7203c8e256f9065d", + "learn/all/": "6fd8615c101c7bba11a23335bc80ce285ef6ec8c43df107a334610d3c5814c33", "learn/an-encoder-block/": "18f9e0dcc364af47a9eea1f34e7585bcf1a21784a8930da4c51c7f72e997ce6b", "learn/an-honest-scoreboard/": "f782a3681c0ebc3b23fed57524c87b069c354c69c55f9dd6c4b7139b188096e2", "learn/anatomy-of-a-tb/": "afd78394163c92ecf1c9d0f423f3d7f1c3f34380b8a7ffbb27e1f376950d3e3d", "learn/angle-and-magnitude/": "710e2aefd09a2d275c0894186d260df42194fd98128b6a3de74c7a66a081b80c", "learn/arithmetic-and-dsp/": "8ab7bc516268078990dda9c3cfc94468f2f89bc01a453939d1bdafd7d34b86cf", + "learn/arithmetic-and-dsp/all/": "8e1752794a96f2e38a786f8f7b39a295238d1b88489604475b8240414472a870", "learn/arrays/": "672a72dbc0dbd6f2369a486163c6bc344543b913524c03fcac74f71b07c033d5", "learn/assertions/": "b769da059ed61e29a375f4b745144fef3177e80c356cdc2563b95dc98a0a7950", "learn/attention/": "c2b0c62c4c3e959d2d2e07028a9e65d53b7488f4178b16706696a82550143ae6", @@ -53,6 +56,7 @@ "learn/build-verify/": "d1001b940883ca0b4ca9296dd5864de090d9bb03cad1a016a841f39ddad2dda8", "learn/bursts-and-ids/": "790e73f6e2e7c1805e987f693435ab2d0355c33d0e8420235a74f6a8055b62d0", "learn/buses-and-peripherals/": "8f805ce396d7a6d65c0bfdd58e7f98b8097b1aa5f3cc8f9f5aa5c6bc52db91f6", + "learn/buses-and-peripherals/all/": "d83ee389970510a5dab22fdee16412670560fa83e5027d7998da80da4dc0e6ba", "learn/capstone-a-filter-on-the-board/": "2767f218a4d6390f23f6663473a27b3c70eedd665ff824158b38708da49a652d", "learn/capstone-diff/": "9084ceafa86e5ea53def643a8d68c4a3b350580afcb3fbe8301306814ccd1025", "learn/capstone-what-runs-next/": "b0822431331f6dd19364b78049bc805a175d6831b552af6778b9a954ec3500ec", @@ -63,6 +67,7 @@ "learn/chip-select-and-widths/": "7972a1d67115bf43afa2e864bfae21cf616fd48ccd19fdf8014a9590ad5c4b06", "learn/claim-and-release/": "f25c9da4bc5c1f9b1fad24586c030984ec911d248e91cb5e62aa791467312cd8", "learn/clocks-and-cdc/": "50e6bb71c37f2bcb56df6810e89e0d30c6fbb2574fbc1945719d8513b28f6354", + "learn/clocks-and-cdc/all/": "f0f027a66cc70e225ab828bd34c9615b7031f65546eeae9c0b9b1fdd92292791", "learn/comments-and-prose/": "7246f7de8a89ab855da95624e17dc4a5863fe151026a64e8934f325d5d1e19de", "learn/compare-at-the-top/": "6a8629c7a92da42a5277d8e3151bfd12a100e2473d94f71c4524d3d1b44894b2", "learn/compare-traces/": "1eec7ccbb54dac17ccf3c8c523b3c61747c8f03961ffe0a3e7a7b4d84412fa1f", @@ -72,6 +77,7 @@ "learn/constants/": "ce955fb760476ccae55b837ba00d08e4616dc49a520022a5961b55013e253c84", "learn/count-the-cells/": "e9306cc9129ad1bae2c63b3a01b5f6b2aea04cd59972ff87b48acb781d822caf", "learn/course/": "114756b262a60e717b24bfce2fc4bf2b95fad9475ec67128f0f78154aec6972d", + "learn/course/all/": "e94918e4b7a0244d4bdbfe242f8cbea09dcaceb801f177449ba79badb7d8f5c9", "learn/coverage-lies/": "8af79b079afbce35337616aef7794f4459cbeeb1a3bbe6c62dcdfa3200078afa", "learn/create-clock/": "e719aaf80757a0091edfd4f6bc04fe90ac3d2fa2b031210b651d5c130c6ef981", "learn/cross-entropy/": "cfc597aae6d3c2d06d63472566758ef6eea6702b8bbc1b63d39196edb763a86e", @@ -130,6 +136,7 @@ "learn/golden-model/": "d058d05c0bf78a1eb46db27e07fce81ea630dcd31f246005f45652ef4fc9e61d", "learn/golden-ruler-vectors/": "fef5c13c4facd7c3676c32dd95d75c3ecdaaf7c6b1702dcbcc2fa3c8a5de1b05", "learn/goldenfloat/": "ff6f9269c2bc7a545b01210ef87c245ddb91494ea4467d7bcf8c7b214a1a230b", + "learn/goldenfloat/all/": "569653fb8bd29cb6f46f1a7b5c62fcc02b036b2beec4fc448ef36e97a73c8113", "learn/gradient-descent/": "76b26920c3e4995348fb473e447fc8152695e42d6a40989e88d7d791953d1f11", "learn/gray-code/": "5cdd822d021d6cfa9cd4d11bb260c8246f1282d3dc2516c3c0b39bcd81ef7d06", "learn/growth-through-the-stages/": "4b840eed202a22b6de29bd85e53b8081a9d16f413cafdc6a41425c20c396d626", @@ -168,6 +175,7 @@ "learn/multiply-then-add/": "d6a0407858df178e9de0ccc24cded3864ac19f8aaa796466913a9f3713bf3fc7", "learn/negate-twice/": "d8723c28c60ec0e1b4bdc5255af07d23204acea7a126caa544c51aabc7153fed", "learn/neural-networks/": "7855f1ffad9744a591df9c7eeb6af58949b7a7505e7956c307fe450e79fc4043", + "learn/neural-networks/all/": "aae4853e699b16ba01fc4a3efdce9f68a522b87c173e43f5ea213fbc2c59080a", "learn/no-credit-for-keys/": "16327861d57ae08c85ca36a7bd182131487f2b0e5330fda6f60ee765e2dad7b6", "learn/one-edge-one-world/": "5c3e2b05491bd8ac0f6f829324c830f0c3e7c44f7ba83af1a85b25645a3bc395", "learn/one-lut-up-close/": "166f3d723e87272cc8dfa905eec2ff86dc16c2fdef28c6c15988a6925aa6bd65", @@ -198,6 +206,7 @@ "learn/q-formats/": "bb9597c92651aa132631814dbc6d0eff72067d1bc1777b16d3c67346ae4ba9f7", "learn/quantization-noise/": "6e9cad12c183b8afe4cfcf5593c4e431a41ec87056a0fb60f66ca6780489f00b", "learn/queen-and-hive/": "48eb90aeae2e981b3639ecdc3b9be4fb4f43906e2bd8d2d04df26d2cf460fdc2", + "learn/queen-and-hive/all/": "740eb96e45ce7a0934760c7966194c677b67098d728dbb96db984f6ff874e40e", "learn/questions-in-thirds/": "00842bca09d514998bcf058890cf794e7399f69d92203049e3f8b7f9c9dfc043", "learn/read-a-bitstream/": "6e929c80a2d5849da4a1e28f16dcb10fc833a2bb912e62b2e2d2c410c3c1707e", "learn/reading-errors/": "fd80e7b6b9483768bf331dc6706ca2e4321b4d3b204a33c45d5d7fe9b863e66e", @@ -243,6 +252,7 @@ "learn/tables-and-interpolation/": "0a10c09725ee7a0901b2ce55cdadcc07131adabc270838d3017ee8cac415cd14", "learn/tanh-and-saturation/": "75ac9a39d9b6c25677e9036108d4c1c2204ede2f993df1f2445e9cd3a6a297c8", "learn/ternary-computing/": "c3b5ac0b20b38c339719c1c7dd04d5fe88055a16a471148e7913649002567bb4", + "learn/ternary-computing/all/": "97bdc2ebdc2084546a6f4bc0222c737e54805745c2b6556434e0dbd3dbe4f8bd", "learn/ternary-mac/": "8c7eec502e24be9a72a888da5d43ec48d2064ffbf2acd70990cf8c9b3252813a", "learn/test-strength/": "de725d4fe191b20ba1f55eab08050eb7fd31a51c06514def130818494d1fa4e1", "learn/tests-are-the-spec/": "368cde97d35bb09531b6b5d50e4d66d75432ec4a64d40fa3d1d502881e64b18d", @@ -289,6 +299,7 @@ "learn/vcd-format/": "e640528793896dcabc21c5e6856989f05a84254f525461c1e9dfa121d128245d", "learn/verify-capstone/": "4d0587c2f051a226ad0df1cb03ad31fbe62cfe7f8b52df977a3262f75fba7ab6", "learn/verify-hardware/": "6aeaa3d26b1dd2fd13595659d8d416c415548a20d0bb4b16bbc19033255d1428", + "learn/verify-hardware/all/": "add204b9d6410854dfe47f21eb2e18ceea1373f9fa1e8cb815e1c2e6f1b2e471", "learn/what-a-spec-is/": "72def96becff86c609bcdbc629b17057e62a4739020e4be8f644d0e7bf8e9c81", "learn/what-a-vector-is/": "bb99fd108e8148cb426112d6924fb4b439ada35ff68875ba73850c77c6752b04", "learn/what-arithmetic-costs/": "287bf627513a35528f4c1ef93e11a74b0873233cb87a23a2272b8bb115b36f69", @@ -336,11 +347,14 @@ "ru/learn/address-decode/": "08c58078171cfdbb20d55768c98efa29a58e869761dc4d5401a028f0d221a2a9", "ru/learn/aging-a-label/": "014c7593f777b76868bf72d860e2b34e7f269a570496565b96527b70bdde0ea5", "ru/learn/ai-numbers/": "2c3abbe2f6527300151af1755677e763daed3f7af6a80af188f134c45120832f", + "ru/learn/ai-numbers/all/": "7fcc517aff4d2e1d2dc834eaadd07fb142aa10680661d27b6270ce2c38d6da5d", + "ru/learn/all/": "04b99aefe32ad796b7968fddc7eecc56b8e672c71a17c049c5f24278b3380108", "ru/learn/an-encoder-block/": "7882788e01d39206dd8d260ae048ec1308f0d6a9b93729f3797a26fe8f9bbd2f", "ru/learn/an-honest-scoreboard/": "a7a3612e27aedba4c0d67490481efd9d0fb7f4f67a72041d0d3db1ddf6e2adb2", "ru/learn/anatomy-of-a-tb/": "2b6d1945326894f983543e707c0bfbabb9ae42c0b5658bf58275bd23d8e8b245", "ru/learn/angle-and-magnitude/": "f13a34e1e362aab6f669d0579f5e95b4d845a78d57341b493c21ecc4d04bd742", "ru/learn/arithmetic-and-dsp/": "65c5de83d6ac927fed8e568b46dab25054ba3c13ad356c40cd491f1344133699", + "ru/learn/arithmetic-and-dsp/all/": "7fb1790e149e6229efe67452675f1636307da058b909830e00a23fda03129f71", "ru/learn/arrays/": "0e6bbb8781017b1073bb0eb3b8be8664d39295e27b71fcd9988ae5cb8b49723c", "ru/learn/assertions/": "ebf46984f1df8e3ce1b21b643137cc3a1becd01255fd3e0cb4d9c145c4bd3aee", "ru/learn/attention/": "d0c0658e4aef063126a96df015efb66af7f229482109c877a00d554add1afd50", @@ -361,6 +375,7 @@ "ru/learn/build-verify/": "e3be34624a80fb5036e6fe4e528955e577c8313ef00cbe3d3de916a501fffa0e", "ru/learn/bursts-and-ids/": "56246e97e13194fc72d3ffa2526b324e7b000816a1d95150d472caba0af5b703", "ru/learn/buses-and-peripherals/": "bc01cb857adcc026b36318ee07feaa55fd8c37f5f0659b47ae3a10c784cd3dfe", + "ru/learn/buses-and-peripherals/all/": "6a01615a5731e832f736299b50a0f6bcc57910885183e54959d1745c30e2bda8", "ru/learn/capstone-a-filter-on-the-board/": "2dfdcc194fe01202c8e7f8d36c15bee4238ab7dad34dd0e8695975a39dd065d4", "ru/learn/capstone-diff/": "51924c8d561b0dec3106e58848702e5ad30bacd5b8b26867ad90df4e3d7b5fb5", "ru/learn/capstone-what-runs-next/": "79ee4fe56b25284bb5176d34cfafe77e23ae8fac57dd2c0e32ba31f69661c30b", @@ -371,6 +386,7 @@ "ru/learn/chip-select-and-widths/": "d69f7864883d3bb5cdfeb9bff55e3726de5a8a3465e7f212825514fb8edbf12c", "ru/learn/claim-and-release/": "308e9d0bcb2afd80ce9d46705fc94bd14eb985ccfb1fef3037a0dfb95e8dd06c", "ru/learn/clocks-and-cdc/": "1b4aedfe41a1a911388b21472659a8a54ab2089258ba6050d55bbde50ef2dd7a", + "ru/learn/clocks-and-cdc/all/": "39e992069c420164cd371ff85b4e868307814d36bce2aa9ce9b9313dec728869", "ru/learn/comments-and-prose/": "67c6c5860ce342cd44e12600368f3fe23932b8ddd79b6bdce809bff57fc48174", "ru/learn/compare-at-the-top/": "f7e3544e05e77eea85507df1928959ee753b4edf7fb3dfc95ef6510e36524e7b", "ru/learn/compare-traces/": "c1cb6e7462e7f95fa148ec2a0161dc4a04560c5286fc180a4945d76a95d64799", @@ -380,6 +396,7 @@ "ru/learn/constants/": "b09b0ae7902958ec4a88de61535624e06b2332e680ef43213e86fa609a8d4899", "ru/learn/count-the-cells/": "eb61fea92b7914ec0933501f74d23842bbeeb028531fb268828759f8ace049a8", "ru/learn/course/": "b25e966436bc58071a5cfcc0bb4ecac778e9034151696377f2c0927c0b360a6d", + "ru/learn/course/all/": "156d85f9811fe08fefed36ee0135454b7a6c9d46846bbd08ebcee680cae28f36", "ru/learn/coverage-lies/": "746b6ca2452f95d06acd1fabbe3e23e6452cc4e506f3379c893151af4b3b049d", "ru/learn/create-clock/": "f463c64778670c5998d3aff6c0b9c35767c949d992f247636187f0d980469223", "ru/learn/cross-entropy/": "ccb89a8438c5a9fc0c917c60ffdcb1b25843cf7833abbafe82b6516349c3cd84", @@ -438,6 +455,7 @@ "ru/learn/golden-model/": "d6c8477436eb2a9a3c306e7052f557ac5fea8b5e52fa329624d64067fd771763", "ru/learn/golden-ruler-vectors/": "2bcc0aaf56e199f5c5a733ab1907c959400aa3fa161b0f125458da529242bea4", "ru/learn/goldenfloat/": "6bfff0e6ba61da77ed4445759b0939021607e02c33f2c760d758f0eed227a8d9", + "ru/learn/goldenfloat/all/": "ab21e3c8684ee5d2eb650526b8e57c938fa707f75f165c7a2fe7e4e5018ab431", "ru/learn/gradient-descent/": "3bb3989e03d2642ef7465dd317962caa9282f29f9684cd87e9ebb4cc25f958fc", "ru/learn/gray-code/": "d99dc71f49be203e39bd5c3a798b7de890617598d1731c6df4b679cb20cd7e09", "ru/learn/growth-through-the-stages/": "c51e900ab6924e14aad33cfa533144d8f3ea00e2ce65b49a87d7a19de1ed4f01", @@ -476,6 +494,7 @@ "ru/learn/multiply-then-add/": "61ebf2be71bb9bc7b1391a9ce5f410442dd84eaeb529d588a35ca51501a9edd2", "ru/learn/negate-twice/": "392a6c948a48c4ab72b2cf30d4e1378a95408671c288cdfd3cc4e76569a7ad6a", "ru/learn/neural-networks/": "e2c3701580205e96e14ab12193840f3d50c12e83578151df327a680e9f923f94", + "ru/learn/neural-networks/all/": "abaf4c4a689ebabeb4ebb3a237446a0ccfa991af741645ee292759ddf526018c", "ru/learn/no-credit-for-keys/": "6ad5e601bc14a2c578b9cc04809e5d652aa3347a85faabf5d6884e1701b8576a", "ru/learn/one-edge-one-world/": "2259c1b021214040d6e338b1b806a2cd6220c651a45b8d2154afa534a31f478a", "ru/learn/one-lut-up-close/": "3f41d0df7387a37b49b04b2f443fa6777ed1bf02a72efab59ad537a31aa215f8", @@ -506,6 +525,7 @@ "ru/learn/q-formats/": "17f3e29df1567b81e1ebe4383e328157f874301b7d84897d65701ae70887b2c2", "ru/learn/quantization-noise/": "c42fb391df5346fd3db4f28a3a3af26e6687161f7de05b08d19d87a2f54bec0d", "ru/learn/queen-and-hive/": "56d37b7e312ee73d8b011235408ed7c56527a945f543f2ca73a97daf9c9667f8", + "ru/learn/queen-and-hive/all/": "48f24c22851e63dc1b593878566bc4d7cccead723776e9856b5d55e906d21c7c", "ru/learn/questions-in-thirds/": "5f116646bdb6151435a38e20c632ce0355aaca3b2b8f6f9910056279ee18367b", "ru/learn/read-a-bitstream/": "dd8e56af7d6109c70d3df54587a16457ff42b8b463a4be851c0c8544b1b5d5de", "ru/learn/reading-errors/": "08ad4f65e5ebb8133be23f8aa5aceaaebcb3c86c540f54b77935d140f1201712", @@ -551,6 +571,7 @@ "ru/learn/tables-and-interpolation/": "2c573c7c8f5b7d35f749ceefc1f05f9f887c1c3ca732b6d3be9581a8d0a3a5c5", "ru/learn/tanh-and-saturation/": "495d8a1e8e094e7c09db71675082f69263100078e2a318778cc0a7dfe4a3f237", "ru/learn/ternary-computing/": "70ced8c1a029088201cac11f0c42d6dad3762a948257ba915967f23addccf5e4", + "ru/learn/ternary-computing/all/": "9a26d6fb5757b6977709466292beeae2b80abb257733306b1fdf604a86faf274", "ru/learn/ternary-mac/": "78a69adde95b30b14754a617d90bf487f86cd6a45e8ce579373e152858cba44f", "ru/learn/test-strength/": "b5652fad4a063c794dfb4f2e68ae1cb23ef1e3ead93e67c95ace3b4920daed94", "ru/learn/tests-are-the-spec/": "51fe316eac93d50273360f4a0352b71d42f12c4dfd6471a503abed30d7813130", @@ -597,6 +618,7 @@ "ru/learn/vcd-format/": "3b21beb6ef6375a085efdcbbbc3213da73553b0eacd6cb681825522c23915a74", "ru/learn/verify-capstone/": "aecde067fcf05643180842bce0c48918db42c873012b033837bd09d3d4e3ce2f", "ru/learn/verify-hardware/": "84994092bed8a23ac4ca691e5fc5446f19665c9110d70343b0f4ab918d5a6c26", + "ru/learn/verify-hardware/all/": "b8ea0237846fc4d6464e26f01b4a1e2369ca49dec650e130b97039fcc8326484", "ru/learn/what-a-spec-is/": "da4885fd5f5b052cbd06aa01addfc65081f39786ece5dc7551d6b9a2364f6dec", "ru/learn/what-a-vector-is/": "b39953b67a0b6bd45956854cf67c200b487290c1a0411848ab33c5d910a35c88", "ru/learn/what-arithmetic-costs/": "f3276ccf32ceb9422526de4919a57872cbf2b55a5f4d0bf7f6cbc29aa3148d73", diff --git a/apps/website/public/learn/carry-save/index.html b/apps/website/public/learn/carry-save/index.html index 54cef45607..2172cafc42 100644 --- a/apps/website/public/learn/carry-save/index.html +++ b/apps/website/public/learn/carry-save/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Three numbers at once

You will learn

How 3:2 counters add many numbers with almost no carry propagation, and how many layers k numbers need.

A 3:2 counter is a row of full adders with nothing between them: three numbers in, a sum word and a carry word out, and the two add up to the three. Layers of them squeeze k numbers to two before one ordinary adder finishes. The Dadda heights 2, 3, 4, 6, 9, 13, 19, 28, 42, 63 are the most numbers each count of layers can reduce, so 9 numbers need 4 layers and 64 need 10. For 9 numbers of 16 bits that is 20 full-adder delays against 128 for a chain of adders.

Try it

Set 28 numbers and then 29: how many layers does each need, and why does one more number cost a layer? Then check that sum + carry equals a + b + c in the counter below.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Carry-save adders: add many numbers with almost no carries
Carry-save adders: add many numbers with almost no carries ↗

Set how many numbers to add and watch 3:2 counters squeeze them to two, layer by layer, before a single carry-propagate adder. Then try one counter on three numbers.

specs/fpga/dsp/adders.t27

// SPDX-License-Identifier: Apache-2.0
@@ -552,6 +584,7 @@ 

Three numbers at once

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/cdc-report/index.html b/apps/website/public/learn/cdc-report/index.html index 231f68fd07..dd528151d0 100644 --- a/apps/website/public/learn/cdc-report/index.html +++ b/apps/website/public/learn/cdc-report/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The CDC report

You will learn

What a CDC report lists and asks of every crossing, and what a report of verified things has in common with it.

A CDC report walks every crossing in the netlist and asks each one: synchronized, and how well? It names the unsynchronized paths, the synchronizers with too few stages, the buses that forgot their Gray. The widget is another report of named things, each checked: 129 files held intact against the newest of 54 content-addressed snapshots -- not a CDC report, but the same shape, a list where every line is a verdict with a source. The spec frame opens timing.t27, the arithmetic such a report leans on when it estimates how safe a synchronizer is.

Try it

In the widget, find how many files the report holds intact and how many snapshots it checks against; then in the spec frame find the estimate a CDC report would run per crossing.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri game-vault: the loop's skills checked against snapshots
tri game-vault: the loop's skills checked against snapshots ↗

129 files intact against the newest of 54 content-addressed snapshots.

specs/fpga/timing.t27

// SPDX-License-Identifier: Apache-2.0
@@ -446,6 +478,7 @@ 

The CDC report

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/chip-select-and-widths/index.html b/apps/website/public/learn/chip-select-and-widths/index.html index 628f6640a0..8550781d85 100644 --- a/apps/website/public/learn/chip-select-and-widths/index.html +++ b/apps/website/public/learn/chip-select-and-widths/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Chip select and widths

You will learn

How a chip select picks the listener, and how wide a transfer may be.

The chip select is the addressing of SPI: pull one CS low and that servant listens, hold the others high and they stay silent. The spec gives the select its timing -- CS_ASSERT_DELAY and CS_DEASSERT_DELAY at 100 ns each -- and the width its bounds: spi_set_data_width_8 and spi_set_data_width_32 bracket a MAX_DATA_WIDTH of 32. The recording lowers the SPI testbench spec to Verilog.

Try it

In the recording, find the bench's Verilog; then in the spec frame find both CS delays and the two width tests that bracket the maximum.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on spi_tb.t27 -- the testbench as RTL
t27c gen-verilog on spi_tb.t27 -- the testbench as RTL ↗

The SPI testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/spi_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Chip select and widths

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/claim-and-release/index.html b/apps/website/public/learn/claim-and-release/index.html index 7112b2f48c..2a2d52d9a5 100644 --- a/apps/website/public/learn/claim-and-release/index.html +++ b/apps/website/public/learn/claim-and-release/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Claim and release

You will learn

How a claim is taken and given back, and why the discipline matters.

A claim is a promise: one client holds the lock, works, and gives it back. The recording takes the claim with tri fpga-claim and the chip that follows it gives it back with tri fpga-release -- take and return recorded back to back, the bench reporting who holds it and then itself free. The spec is the tool card of tri fpga-claim.

Try it

In the recording, watch the claim land and the release land; then in the spec frame find what tri fpga-claim refuses when the lock is held.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-claim -- taking the bench lock
tri fpga-claim -- taking the bench lock ↗

The bench claim in action: one client takes the hardware lock and the tool reports who holds it.

specs/tools/trios/tri/fpga-claim.t27

// SPDX-License-Identifier: Apache-2.0
@@ -107,6 +139,7 @@ 

Claim and release

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/clocks-and-cdc/all/card.png b/apps/website/public/learn/clocks-and-cdc/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..d9e2604e70473a7a9d86b90a697d16fced990bea GIT binary patch literal 37336 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 + + + + + +Clocking, resets and clock-domain crossings with t27: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

Clocking, resets and clock-domain crossings with t27

+

It picks up where the AI numbers course ends. Every lesson opens a real tool or a recording of t27c on a real machine, next to a spec you can run in your browser.

+

Course 3, 27 lessons, one widget and one t27 spec each: what a clock is and where it enters the board, the clock tree, the MMCM, the three reset kinds, metastability and MTBF, crossing many bits, the asynchronous FIFO, the constraints file, and the crossings read back on real hardware. Every number comes from a spec or a recorded run.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · What a clock is

One edge, one world: what shares a clock edge shares a world, the period and the jitter of a real edge, and where the clock enters a board.

+
+
01

Lesson 1 of 27

One edge, one world

+
+

You will learnWhat a clock domain is, the four ways clock_domain.t27 names to cross one, and what the native compiler checks of them.

A clock domain is every flip-flop that shares one clock edge. Move a signal between two domains and the receiving edge can sample it mid-change: that is the whole subject of this course. clock_domain.t27 names the four ways across in one enum: no_cross, two_flop, fifo_async, handshake. Module 5 takes two_flop apart, module 6 the handshake, module 7 the FIFO. The recording runs the native t27c on this spec: 12 tests pass and 5 invariants are proved while it compiles. The player compiles the spec in your browser; where the browser cannot run a check it skips it and says why.

Try it

In the recording, count the passing tests and the proved invariants; then in the spec frame find the four crossing strategies and name the module of this course that takes each one apart.

+
t27c on clock_domain.t27 -- the CDC spec, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/clock_domain.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

A period, an edge, and jitter

+
+

You will learnWhat a clock carries besides frequency, what jitter does to an edge, and what a tool-card spec is for.

A clock is a period with an edge in it, and the edge is not perfectly placed: cycle to cycle it wanders by the jitter. The spec of the tri clocks tool card is not a test suite, and the recording shows its native report saying exactly that: 0 tests, because it is constants a tool page reads. Every constant on that card names the tool output it came from. Jitter eats the margin a setup calculation leaves: the clock-tree spec of the next module carries 50 ps of PLL jitter as one of its constants.

Try it

In the recording, find the line that says why the report counts 0 tests; then in the spec frame read the constants and find where each names the tool output it came from.

+
t27c on clocks.t27 -- the tri clocks card, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/clocks.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

Where the clock enters

+
+

You will learnWhere a board's clock really comes from, and how a ring oscillator inside the chip was measured on three dice over JTAG.

The clock enters the board, not the chip: an oscillator on the PCB drives a pin. The board spec of the QMTech Wukong (XC7A200T in an FGG676 package, part xc7a200tfgg676) also measures a clock that never leaves the chip: CFGMCLK, a ring oscillator with no crystal behind it. UG470 gives 65 MHz nominal over a 50-80 MHz envelope. It was measured on the three attached dice by timing a 2^24 prescaler over JTAG: 70770, 68490 and 67200 kHz. The recording runs the native t27c on the board spec: 15 tests pass, 11 invariants are proved comptime.

Try it

In the recording, find the three measured CFGMCLK values and the busdev numbers of their dice; then in the spec frame find the UG470 envelope they are compared with and the prescaler that made them readable.

+
t27c on wukong_v1.t27 -- the board spec, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/boards/wukong_v1.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · Clock trees

Skew and insertion delay, the global buffer network, and the trap of gating a clock with logic.

+
+
04

Lesson 4 of 27

Skew and insertion delay

+
+

You will learnWhy the clock does not reach every flop at once, and what the tree delays of a 7-series chip cost.

The clock does not reach every flop at once: it arrives through a tree, and the spread of arrival times is skew. cts.t27 models that tree with the teaching delays of an Artix-7 in its header: a BUFH at 0.05 ns, a BUFG at 0.1 ns, PLL jitter of 50 ps, and a maximum skew target of 100 ps. The recording runs the native t27c on it: 15 tests pass, 2 invariants are proved comptime. Skew is not noise to remove but a budget to spend: a well-balanced tree spends it evenly, which is what makes one shared edge possible at all.

Try it

In the recording, find the two buffer delays in the header; then in the spec frame find the maximum skew target and the test that compares buffer fanout.

+
t27c on cts.t27 -- clock-tree synthesis, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/cts.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

The global buffer

+
+

You will learnWhat a global buffer is, why it sits on its own network, and what one real build of the whole flow looked like.

A global buffer, BUFG on a 7-series chip, drives the clock on a dedicated low-skew network so the tree of the last lesson has a clean root. The widget shows the flow a BUFG sits inside: one real XC7A200T build, 116.9 s with openXC7 and 83.5 s through the t27 L3+L4 path, byte-identical bitstreams, and place and route taking 60 percent of it. The buffer is one layer of that picture, and the spec frame opens cts.t27 again, where bufg() is built and bufg_has_higher_fanout() is tested.

Try it

In the widget, find the two build times and what percentage place and route took; then in the spec frame find bufg() and the test that gives it the higher fanout.

+
tri game-selftest: the queen loop checks its own toolsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/cts.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

The gated-clock trap

+
+

You will learnWhy gating a clock with logic makes a new domain, and what a clock enable is for.

Gating a clock with logic -- an AND gate on the clock line to save power -- cuts the clock with a signal that changes at data speed, makes glitches, and quietly creates a new clock domain of everything downstream. The rule: never gate a clock; use a clock enable, which the flop samples at the edge instead of the edge sampling it. The widget shows the discipline of proving such claims: two bitstreams that differ in three bits, and a knockout build per bit, each clearing one, so no bit can claim credit it does not earn. The spec frame opens clock_domain.t27, whose gated_clk source kind is the model of this trap.

Try it

In the widget, find how many bits the A/B bitstreams differ by and how each was cleared; then in the spec frame find the gated-clock source kind and the strategy enum value a gated clock forces.

+
Race the bee: who lands patches on t27, a person or a beeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/clock_domain.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · PLL and MMCM

Multiply and divide one clock into another, move its phase in steps of the VCO, and which clocks the analyzer treats as related.

+
+
07

Lesson 7 of 27

Multiply and divide

+
+

You will learnHow the MMCM turns one clock into another by multiply and divide, and which windows the numbers must land in.

The MMCM turns one clock into another: the input is divided by D, multiplied by M into an internal VCO, and the VCO is divided by O for the output. mmcm.t27, written for this course, keeps M in eighths so fractional steps stay integer: M 2.000 to 64.000, D 1 to 106, O 1 to 128, and the VCO must land in its window -- 800 to 1600 MHz here, a teaching assumption the header labels, next to the ranges that come from UG472. From 200 MHz in, M 5, D 1: a 1000 MHz VCO, and O 10 gives 100 MHz out. The recording runs the native t27c: 16 tests pass, 4 invariants comptime.

Try it

In the recording, find the 500 MHz configuration the rejection test names; then in the spec frame find which ranges the header says come from UG472 and which are labelled assumptions.

+
t27c on mmcm.t27 -- the MMCM model, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/mmcm.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

Phase and lock

+
+

You will learnHow fine the phase knob is, how the lock model behaves, and what one widened window breaks.

Phase moves in steps of the VCO period divided by 56 -- a faster VCO is a finer knob, which is why phase work wants the VCO high. Lock is modelled with a settling window the header labels as an assumption. The recording widens that assumption by one sed: VCO_MIN_KHZ from 800000 to 400000. The 500 MHz configuration the rejection test names slides inside the widened window, and exactly one test fails, vco_below_the_window_is_rejected -- a test that names the number it refuses is a test that guards the assumption. The recording puts the line back and prints the sha256 of the restored spec.

Try it

In the recording, find the sed line, the test that fails and the sha256 of the restored spec; then in the spec frame compute the phase step for a 1000 MHz VCO.

+
t27c on mmcm.t27 -- widen the VCO window, one test objectsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/mmcm.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Related or not

+
+

You will learnWhen the analyzer checks a path between two clocks and when it must be told they are strangers.

Two clocks are related when one is made from the other -- through the MMCM of module 3 -- and then every path between them is timed: the analyzer knows they share an origin. Strangers get no such path check unless you declare one. timing.t27 is the arithmetic of that check: timing arcs, slack and Fmax with an Artix-7 teaching model, LUT 0.1 ns, BRAM 2.0 ns, DSP 2.5 ns, routing 0.3 ns. The recording runs the native t27c: 25 tests pass, 2 invariants comptime. Related clocks were module 3; making strangers safe is modules 5 to 7.

Try it

In the recording, count the passing tests; then in the spec frame find the four teaching delays of the header and the function that turns arcs into slack.

+
t27c on timing.t27 -- static timing, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/timing.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · Resets

Assert asynchronously, release synchronously: the three reset kinds, the release pipe, and the tree a reset grows.

+
+
10

Lesson 10 of 27

Sync or async

+
+

You will learnThe three reset kinds, which one races the clock, and the shape the course recommends.

A board asserts reset when it wants to, not when your clock says so: the assert may be asynchronous. The release may not be. reset_sync.t27, written for this course, names the three kinds: sync (0), where assert and release both go through the clock; async assert, sync release (1), the usual choice; and async assert, async release (2), which races recovery and removal at every flop it feeds. is_recommended() accepts kinds 0 and 1 with at least 2 stages. The recording runs the native t27c: 16 tests pass, 3 invariants comptime.

Try it

In the recording, find the test that calls async release racy; then in the spec frame read is_recommended() and check what it requires of kind and stages.

+
t27c on reset_sync.t27 -- the reset kinds, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/reset_sync.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

The release pipe

+
+

You will learnHow a reset release walks a shift register, and what the compiler emits for it.

The release walks a shift register: at the destination clock, flop after flop takes its neighbour's value, and the reset is held until the pipe runs dry. The latency is the stage count -- 2 stages release in 2 clocks, 3 in 3. The recording shows what the compiler emits for the model: t27c gen prints the Zig, and the step function is a struct copy, one field per flop, no more. The wc -l at the end of the recording is the size of the whole generated model.

Try it

In the recording, find the wc -l count; then in the spec frame find after_clocks() and check that release latency equals the stage count.

+
t27c gen on reset_sync.t27 -- the release pipe as ZigThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/reset_sync.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

Reset fanout

+
+

You will learnWhy a reset grows a tree like a clock, and where its cost shows up in a real resource count.

A reset reaches every flop in the design, so it grows a tree like a clock tree and is balanced for the same reason: an uneven release is a skew you built yourself. The widget counts a real routed design against the XC7A200T's own totals, read from the chipdb and prjxray-db, and counts yours if you drop your routed JSON on it. A reset tree lives in the same budget: routing and control-set pressure, visible in exactly those bars. The spec frame opens cts.t27 once more, the tree arithmetic that both trees share.

Try it

In the widget, read the totals the bars are counted against; then in the spec frame find the skew target a reset tree is balanced to meet.

+
tri fpga-rxcapThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/cts.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · Metastability

The setup-hold window, the mean time between failures in integer arithmetic, and the two flops that fix it.

+
+
13

Lesson 13 of 27

The setup-hold window

+
+

You will learnWhat setup and hold mean, what a flop does when the window is missed, and what a VCD shows of it.

Every flop has a window around its sampling edge -- setup before it, hold after it. Land a transition inside the window and the flop does not cleanly pick a level: its output can hang between 0 and 1, a metastable state that resolves at a time the datasheet does not promise. The widget reads a .vcd from any simulator and reports value changes, the busiest net, and signals stuck at X or Z: X in a simulation is the testbench's way of showing the window was missed. The spec frame opens clock_domain.t27, whose crossing model is what module 5 turns into arithmetic.

Try it

In the widget, drop a .vcd if you have one and find the busiest net; then in the spec frame find the crossing model the window belongs to.

+
tri fpga-rxerThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/clock_domain.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Mean time between failures

+
+

You will learnHow MTBF prices a crossing in integer log2 arithmetic, and which constants are assumptions.

MTBF prices a crossing: e^(T/tau) divided by F_clk, F_data and the window W -- the form Xilinx WP323 teaches. mtbf.t27, written for this course, computes it in integer log2 with 10 fractional bits, because the honest answer overflows every integer seconds count. tau 50 ps and W 10 ps are labelled assumptions: the vendors publish flop parameters only partially. At 100 MHz receiving a 10 MHz stream, 1 stage leaves -200 ps of slack and a Q10 log2-MTBF of -19513 -- under two microseconds; 2 stages leave 9800 ps and 275887 -- beyond any clock the universe will run. The recording runs the native t27c: 15 tests pass, 4 invariants comptime.

Try it

In the recording, find the grep that lists the assumptions; then in the spec frame compute what stage_gain_q10() says one more flop buys at 100 MHz.

+
t27c on mtbf.t27 -- MTBF in integer log2, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/mtbf.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

The two-flop synchronizer

+
+

You will learnWhy two flops are the fix, and what the generated model of the crossing looks like.

The fix is two flops in the destination clock, nothing between them: the opening one may go metastable, and the second samples its settled output a full period later. Each extra stage multiplies MTBF by 2 to the power T_clk times log2 e over tau -- 295400 in Q10 at 100 MHz, the spec's stage_gain_q10(). The recording shows t27c gen on clock_domain.t27: the printed Zig is the crossing model the whole course leans on, and wc -l counts it. What the two flops cost is latency: two destination clocks from edge to settled output, the same price the release pipe of module 4 pays.

Try it

In the recording, find the wc -l count of the generated model; then in the spec frame find the two_flop strategy and say which module took it apart.

+
t27c gen on clock_domain.t27 -- the CDC model as ZigThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/clock_domain.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · Crossing many bits

Why a binary bus tears, why Gray code does not, and the handshake that moves a pulse between worlds.

+
+
16

Lesson 16 of 27

Why binary fails

+
+

You will learnWhy sampling a binary bus mid-change tears it, and what the FIFO spec checks of its pointers.

Cross a multi-bit bus by sampling it in another domain and it tears: some bits arrive from before the change, some from after, and the value you read never existed. A binary counter is the worst carrier -- 7 to 8 flips four bits at once. fifo.t27 is the buffer that does this properly, and its head advances as (head_ptr + 1) % depth, with MAX_FIFO_DEPTH 65536. The recording runs the native t27c on it: 18 tests pass, 6 invariants comptime. What the tests check is fill counts and flags; the next lesson shows what they never check.

Try it

In the recording, count the passing tests and the proved invariants; then in the spec frame find the head pointer update and the maximum depth constant.

+
t27c on fifo.t27 -- the FIFO stdlib, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/fifo.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

Gray code

+
+

You will learnWhy Gray code changes one bit at a time, and what a test suite that never reads pointers cannot see.

Gray code changes exactly one bit per step, so a sample taken mid-change reads one of two adjacent codes -- off by one, never garbage. A FIFO whose read and write pointers count in Gray can be sampled across domains safely, and the flags derived from them hold. The recording plants a mutation that Gray would have caught red-handed if the tests had looked: (state.head_ptr + 1) becomes + 3, and every test still passes, because the suite asserts fill and flags, never pointer values. A test suite defends what it reads; the encoding is defended by the next lesson's rule, not by these tests. The recording restores the spec and prints its sha256.

Try it

In the recording, find the sed line and confirm that no test failed; then in the spec frame find the fill and flag assertions and point at the hole the mutation slipped through.

+
t27c on fifo.t27 -- a pointer mutation the tests cannot seeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/fifo.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

Handshakes and pulses

+
+

You will learnHow a handshake moves a pulse between worlds, and what an edge-driven report and a toggle synchronizer share.

A pulse is the hardest thing to move: one clock wide here is not one clock wide there. The handshake turns it into a level: the sending side raises a request, the receiving side samples it, raises an acknowledge, and the request drops -- four edges, and the pulse became a conversation. The widget is a report that works the same way: 25 live checks, printing only rows that are NEW red or CLEARED since the last look -- the far side sees the change, not the level, exactly what a toggle synchronizer arranges in hardware. The spec frame opens clock_domain.t27, whose handshake strategy is this conversation as one enum value.

Try it

In the widget, find how many checks the report runs and what it prints when nothing changed; then in the spec frame find the handshake strategy and count the edges its conversation takes.

+
tri game-tick: one anomaly scan, only what changedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/clock_domain.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · The asynchronous FIFO

Pointers, flags and depth: the buffer that moves a stream between two clocks.

+
+
19

Lesson 19 of 27

Pointers and flags

+
+

You will learnHow the flags are derived from the pointers, which signals actually cross, and what one flipped assignment breaks.

The data does not cross; it lives in BRAM and both sides address it. What crosses is the pointers, in Gray, and the flags derived from them: empty when the pointers match, full when they differ by the depth. The recording breaks the flag arithmetic with one flipped assignment -- push sets flags.empty to true -- and exactly one test fails, push_increments_fill, the one that asks a push for a non-empty FIFO. The recording restores the spec and prints its sha256. The spec frame opens fifo.t27, where push and pop build the flags the crossing carries.

Try it

In the recording, find the flipped assignment and the one test that fails; then in the spec frame find where push builds the flags and derive empty from the pointers yourself.

+
t27c on fifo.t27 -- break a flag, one test objectsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/fifo.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

Sizing the depth

+
+

You will learnHow depth follows from the write rate, the read rate and the worst burst, and what a real timed loop measures.

Depth is not a feeling: writes at rate W, reads at rate R, and the buffer must hold the worst burst times (W - R) over the time it lasts. Oversize it and it costs BRAM you could have spent; undersize it and it overflows silently, because a full FIFO drops or blocks and neither shows up in a waveform. The widget is a real loop with a measured time -- 19.06 s for router1, bitwalk, xc7frames2bit and the SRAM load, on a laptop at load average about 110 -- the same arithmetic of rate and time that sizes a buffer, measured on a run that really happened. The spec frame opens fifo.t27, whose fill_count is the number this lesson is about.

Try it

In the widget, find the loop's measured time and the load average it ran at; then in the spec frame find fill_count and write the depth formula for your own worst burst.

+
tri competitors audit: the table, auditedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/fifo.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

The FIFO testbench

+
+

You will learnWhat a testbench discipline looks like when it is real, and why this lesson opens the FIFO spec and a mutation recording instead.

A testbench for the asynchronous FIFO would drive both clocks, tear the pointers on purpose and check that the flags never lie. The testbench spec in this tree is not that yet: it does not compile in the browser compiler and native runs are blocked on it, so this lesson opens fifo.t27 itself and, in place of a FIFO testbench, a recording of the discipline it would follow: 5 planted bugs in packets.t27 -- a CRC polynomial bit, a CRC address width, LFRM no-ops, a COR0 bit, a type-2 word count -- each mutant rebuilt and re-swept, every one caught. When a real testbench spec lands, this lesson takes it.

Try it

In the recording, list the 5 planted bugs and count how many were caught; then in the spec frame find the flags a real testbench would have to tear on purpose.

+
tri discard top: what the parser throws awayThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/fifo.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · Constraints

The lines that tell the analyzer what a clock is, which paths not to check, and what the pins must meet.

+
+
22

Lesson 22 of 27

create_clock

+
+

You will learnWhat the create_clock line tells the analyzer, and which spec writes it.

Until a create_clock line exists, the analyzer sees no clock at all and times nothing: every path is unconstrained and every report is empty. The line names the port, the period and the waveform edges. emitter_xdc.t27 is the spec of the emitter that writes such lines from a pins spec -- its text carries create_clock -add -name among the lines it emits. The native test-report on this spec is blocked in the current tree, so the recording shows what does run: t27c parse of the spec, clean, and the grep that finds its create_clock lines. The player compiles the spec in your browser.

Try it

In the recording, find the create_clock lines the grep returns; then in the spec frame find the emitter's line builder and say what a missing create_clock does to a timing report.

+
t27c on emitter_xdc.t27 -- the XDC emitter, parsedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/pins/emitter_xdc.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

False paths and max delay

+
+

You will learnWhat a false path declares, what a max delay bounds instead, and what removing a check looks like in a repository.

set_false_path tells the analyzer a crossing is asynchronous: stop reporting it, the synchronizer owns it. Used beyond that, it silences real failures, so a CDC flow pairs it with set_max_delay, which bounds a synchronizer path instead of ignoring it -- the two or three flops must still be close in time. A false path is a check deliberately removed, and the widget shows what removing checks looks like in a repository: 14 days of merged pull requests, which added tests, changed them or removed asserts, with the exact lines from git. The spec frame opens timing.t27, the analysis the exceptions carve holes in.

Try it

In the widget, find a pull request that removed asserts and the exact lines it took; then in the spec frame find the slack arithmetic a false path silences.

+
tri fpga-txhold: setup and hold from the routed SDFThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/timing.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

IO timing

+
+

You will learnHow IO timing is stated against a clock another chip drives, and what margins read from an SDF look like.

A pin's timing is stated against a clock another chip drives: set_input_delay and set_output_delay, negative before the edge, positive after. The widget shows what such margins look like when they are read instead of assumed: two recorded model runs over the routed E3 design for the AX7203 board (XC7A200T in an FBG484 package), printed -- smallest TX hold 3445 ps on eth_txd[1], smallest RX mid-nibble margin 10900 ps on rxctl_n, both PASS -- a model over nextpnr's own SDF of the routed design, not a board measurement, and it says so. The spec frame opens emitter_xdc.t27 again, the emitter these lines would go into.

Try it

In the widget, find the smallest TX hold and the pin it was measured on; then in the spec frame find where the emitter would put the input and output delays.

+
tri fpga-txhold · RGMII margins from nextpnr's own SDFThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/pins/emitter_xdc.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · On the board

A CDC report, one crossing captured at the flip-flops, and the bitstream diff that closes the course.

+
+
25

Lesson 25 of 27

The CDC report

+
+

You will learnWhat a CDC report lists and asks of every crossing, and what a report of verified things has in common with it.

A CDC report walks every crossing in the netlist and asks each one: synchronized, and how well? It names the unsynchronized paths, the synchronizers with too few stages, the buses that forgot their Gray. The widget is another report of named things, each checked: 129 files held intact against the newest of 54 content-addressed snapshots -- not a CDC report, but the same shape, a list where every line is a verdict with a source. The spec frame opens timing.t27, the arithmetic such a report leans on when it estimates how safe a synchronizer is.

Try it

In the widget, find how many files the report holds intact and how many snapshots it checks against; then in the spec frame find the estimate a CDC report would run per crossing.

+
tri game-vault: the loop's skills checked against snapshotsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/timing.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

Capture a crossing

+
+

You will learnHow one crossing was captured at the flip-flops on a real board, and what the recorded run printed.

One crossing, captured where it lands: at the RX flip-flops themselves. The tri fpga-rxcap command models the E3 RX capture on the AX7203 board (XC7A200T in an FBG484 package) in the same SDF the last module used, and its recorded run printed: falling-edge hold 10900 ps on rxctl_n, with RXC 2.4 ns behind its data through the BUFG, so rxd_p1 and an RX_ER nibble sample the new value over a window the model states. The spec is a tool card -- constants for a tool page, 0 tests, and the recording shows the native report saying exactly that. The pins it captures are the far end of every lesson before this one.

Try it

In the recording, find the recorded hold margin and the delay through the BUFG; then in the spec frame read the tool card's data sources and say what the model did not measure.

+
t27c on fpga-rxcap.t27 -- the RX capture card, nativeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/fpga-rxcap.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

Capstone: change it and diff it

+
+

You will learnHow the pieces of this course meet in one build, and what a bitstream diff says about a change.

Close the loop: change one thing about a crossing -- a synchronizer stage, a Gray pointer, a constraint -- rebuild, and ask the bitstream what moved. The widget compares two Xilinx 7-series bitstreams in your browser: header, packets, and every 101-word frame, with the differing frame address decoded; nothing is uploaded. A CDC change that claims to change nothing should diff to nothing, and one that means something shows exactly which frames it touched. The spec frame opens fifo.t27, the buffer this course built crossing by crossing, and its 18 passing tests are the receipt.

Try it

In the widget, drop two bitstreams if you have them and find the differing frame; then in the spec frame pick one test of the FIFO and say what change would break it.

+
tri blog list: every t27.ai post and its receipt stateThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/fifo.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · What a clock is
    1. 01 One edge, one world
    2. 02 A period, an edge, and jitter
    3. 03 Where the clock enters
  2. 02 · Clock trees
    1. 04 Skew and insertion delay
    2. 05 The global buffer
    3. 06 The gated-clock trap
  3. 03 · PLL and MMCM
    1. 07 Multiply and divide
    2. 08 Phase and lock
    3. 09 Related or not
  4. 04 · Resets
    1. 10 Sync or async
    2. 11 The release pipe
    3. 12 Reset fanout
  5. 05 · Metastability
    1. 13 The setup-hold window
    2. 14 Mean time between failures
    3. 15 The two-flop synchronizer
  6. 06 · Crossing many bits
    1. 16 Why binary fails
    2. 17 Gray code
    3. 18 Handshakes and pulses
  7. 07 · The asynchronous FIFO
    1. 19 Pointers and flags
    2. 20 Sizing the depth
    3. 21 The FIFO testbench
  8. 08 · Constraints
    1. 22 create_clock
    2. 23 False paths and max delay
    3. 24 IO timing
  9. 09 · On the board
    1. 25 The CDC report
    2. 26 Capture a crossing
    3. 27 Capstone: change it and diff it
+ + + + + diff --git a/apps/website/public/learn/clocks-and-cdc/index.html b/apps/website/public/learn/clocks-and-cdc/index.html index b8de797039..1b6630f57d 100644 --- a/apps/website/public/learn/clocks-and-cdc/index.html +++ b/apps/website/public/learn/clocks-and-cdc/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

Clocking, resets and clock-domain crossings with t27

It picks up where the AI numbers course ends. Every lesson opens a real tool or a recording of t27c on a real machine, next to a spec you can run in your browser.

Course 3, 27 lessons, one widget and one t27 spec each: what a clock is and where it enters the board, the clock tree, the MMCM, the three reset kinds, metastability and MTBF, crossing many bits, the asynchronous FIFO, the constraints file, and the crossings read back on real hardware. Every number comes from a spec or a recorded run.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/comments-and-prose/index.html b/apps/website/public/learn/comments-and-prose/index.html index f4c2a609a6..798434f5c7 100644 --- a/apps/website/public/learn/comments-and-prose/index.html +++ b/apps/website/public/learn/comments-and-prose/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Comments and prose lines

You will learn

Where each kind of note may stand, and the one line that breaks the parser.

A line that starts with a semicolon is prose: the compiler skips the rest of the line. Prose lines stand at the top level, between declarations. Two slashes start a comment anywhere, after code or inside a test. One trap: a semicolon alone on its line is not an empty prose line, it is a parse error, and the whole spec fails. Put a word after it, or leave the line empty.

Try it

Add a line with a lone semicolon to the lesson spec in the player, read the error, then remove it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 3: where comments may stand
t27 basics 3: where comments may stand ↗

Prose lines, slash comments and the lone semicolon that breaks a t27 spec, each checked with the real compiler. Lesson 3 of the t27 basics course.

specs/basics/03_comments_and_prose.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

Comments and prose lines

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/compare-at-the-top/index.html b/apps/website/public/learn/compare-at-the-top/index.html index 5881bc9128..d075e43466 100644 --- a/apps/website/public/learn/compare-at-the-top/index.html +++ b/apps/website/public/learn/compare-at-the-top/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Compare at the top

You will learn

Why balanced-ternary numbers compare at their first differing trit.

In balanced ternary the trits below place i add up to less than half of 3^i, so the highest differing trit decides any comparison. 41 is +---- and 39 is 0+++0: they differ in the top trit, so 41 is greater although its tiles show four minus signs. The spec's compare() reads that trit and is checked against plain less and greater on 714 pairs.

Try it

Find two numbers that first differ in their lowest trit, and two that differ in every trit.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Compare at the first differing trit
Compare at the first differing trit ↗

Two numbers line up trit by trit; the first place from the top where they differ decides. The answer is itself a trit.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Compare at the top

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/compare-traces/index.html b/apps/website/public/learn/compare-traces/index.html index d7722ef9e4..cfd6a5e7e0 100644 --- a/apps/website/public/learn/compare-traces/index.html +++ b/apps/website/public/learn/compare-traces/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Compare two traces

You will learn

How to diff two runs and have the trace name the earliest cycle where they split.

Two runs of the same testbench, one before a change and one after: the fastest question is where they split. A trace diff answers at the resolution of one signal change: the earliest cycle where the golden run says 1 and the new run says 0. The widget diffs files this way, frame by frame, and refuses to say 'same' when a byte differs. The lesson's spec is the testbench that drives the VCD comparison tool -- expected against actual, with the mismatch printed, not eyeballed.

Try it

Open the diff widget on two files of your own; then find in the compare testbench where the earliest mismatching cycle would be printed.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Bitstream diff: two 7-series .bit files, frame by frame
Bitstream diff: two 7-series .bit files, frame by frame ↗

Drop two Xilinx 7-series bitstreams: header, packets and every 101-word frame compared in your browser, the first differing frame address decoded. Nothing is uploaded.

specs/fpga/testbench/vcd_conformance_compare_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -179,6 +211,7 @@ 

Compare two traces

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/compiler-stages/index.html b/apps/website/public/learn/compiler-stages/index.html index 62b9177043..13bcf959e3 100644 --- a/apps/website/public/learn/compiler-stages/index.html +++ b/apps/website/public/learn/compiler-stages/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The stages of t27c

You will learn

The path a spec takes inside t27c: tokens, syntax tree, types, HIR, code.

t27c reads a spec in stages. The lexer cuts the text into tokens. The parser builds a syntax tree. The type checker checks every width and every call. The tree is lowered to HIR, a simpler form, and each backend writes code from it. This widget runs those stages on a spec in your browser and shows what each one produced, so an error has a stage you can point at.

Try it

Pick an example and step through the stages; find the stage where a type error would stop.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Inside t27c: watch a compiler read your code, stage by stage
Inside t27c: watch a compiler read your code, stage by stage ↗

Edit a small t27 spec and see what the real t27c compiler, running as WebAssembly in your tab, makes of it: tokens, tree, type check, HIR and code in seven languages.

specs/tutorial/06_structs_enums_switch.t27

// SPDX-License-Identifier: Apache-2.0
@@ -208,6 +240,7 @@ 

The stages of t27c

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/compiles-is-not-correct/index.html b/apps/website/public/learn/compiles-is-not-correct/index.html index e416539d9d..87e99eb3bd 100644 --- a/apps/website/public/learn/compiles-is-not-correct/index.html +++ b/apps/website/public/learn/compiles-is-not-correct/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Compiles is not the same as correct

You will learn

Why green checks are not proof, and how to catch code that compiles and is wrong.

A compiler that accepts your code only tells you the code is well formed. It does not tell you the code means what you meant. This recording shows a tool that found specs which compile, pass every gate and are still read wrongly. The lesson for hardware is sharper still: a bug in silicon cannot be patched. Plant a bug yourself in the mutation recording and watch the tests catch it.

Try it

Open the mutation recording under Also try and count how many planted bugs the tests caught.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri misread: code that compiles and is wrong
tri misread: code that compiles and is wrong ↗

1,144 of 1,156 specs generate; 41 spec-shape pairs are read wrongly with every gate green.

specs/tutorial/03_operators.t27

// SPDX-License-Identifier: Apache-2.0
@@ -177,6 +209,7 @@ 

Compiles is not the same as correct

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/consensus-and-any/index.html b/apps/website/public/learn/consensus-and-any/index.html index 91a71e0ca6..d2f783746e 100644 --- a/apps/website/public/learn/consensus-and-any/index.html +++ b/apps/website/public/learn/consensus-and-any/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Consensus and any

You will learn

Two gates that only make sense with three values.

CONSENSUS keeps a value both inputs agree on and answers unknown otherwise; ANY takes whichever input is decided and answers unknown only when the two contradict. With two values neither gate has a counterpart, which is part of why a two-input ternary gate has 19683 possible tables. Both are fn bodies of trits.t27, tested on the input pairs that tell them apart.

Try it

Find the inputs where CONSENSUS and ANY give different answers, and name a sensor problem where each would be the right choice.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Consensus and any: gates binary logic does not have
Consensus and any: gates binary logic does not have ↗

Consensus keeps a value both inputs agree on; any keeps the decided input when the other is unknown. Neither exists with two values.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Consensus and any

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/constants/index.html b/apps/website/public/learn/constants/index.html index 9e017d8528..e0cf46586f 100644 --- a/apps/website/public/learn/constants/index.html +++ b/apps/website/public/learn/constants/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Constants

You will learn

The six pieces of a constant declaration and what each one does.

pub const WIDTH : u8 = 8; reads left to right: pub makes the name visible to other modules, const says the value is fixed, WIDTH is the name, u8 is the type, 8 is the value, and the semicolon ends it. Constants are what this site's test runner can check: the lesson spec declares WIDTH, HEIGHT and AREA and tests that 8 times 4 is 32.

Try it

Change AREA in the lesson spec to 33 and watch which test fails.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 4: a constant, piece by piece
t27 basics 4: a constant, piece by piece ↗

The six pieces of a t27 constant declaration in one table. Lesson 4 of the t27 basics course.

specs/basics/04_constants.t27

// SPDX-License-Identifier: Apache-2.0
@@ -81,6 +113,7 @@ 

Constants

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/count-the-cells/index.html b/apps/website/public/learn/count-the-cells/index.html index e57923e98d..9923a22fc8 100644 --- a/apps/website/public/learn/count-the-cells/index.html +++ b/apps/website/public/learn/count-the-cells/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Count the cells

You will learn

How to count what a synthesizer built: LUTs, flip-flops, DSPs, block RAM.

After synthesis, yosys can print what it built as JSON: how many LUTs, flip-flops, DSPs and block RAMs. Those counts are an honest measure of a design before place and route. Paste a stat -json from yosys into the stat card, or open the real sample, and get a card and a README badge that say plainly that they are a synthesis count.

Try it

Open the real sample, then read the LUT and FF counts on the card.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Stat card: your yosys stat -json as a card and a README badge
Stat card: your yosys stat -json as a card and a README badge ↗

Paste yosys stat -json: LUT, FF, DSP and BRAM counts, the top module and the yosys version on a 1200x630 card plus a README badge SVG. Read in your browser.

specs/tutorial/04_control_flow.t27

// SPDX-License-Identifier: Apache-2.0
@@ -220,6 +252,7 @@ 

Count the cells

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/course/all/card.png b/apps/website/public/learn/course/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..454f96554852dcfdd2338f580e8a94512d56bdb4 GIT binary patch literal 35339 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 literal 0 HcmV?d00001 diff --git a/apps/website/public/learn/course/all/index.html b/apps/website/public/learn/course/all/index.html new file mode 100644 index 0000000000..4d9559ccaf --- /dev/null +++ b/apps/website/public/learn/course/all/index.html @@ -0,0 +1,482 @@ + + + + + + +From zero to a chip: FPGA programming with t27: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

From zero to a chip: FPGA programming with t27

+

No hardware background needed. Every lesson opens a real tool built from real runs on our bench: read a little, then try it yourself.

+

27 lessons, one working widget and one t27 spec each: what an FPGA is, how numbers become bits, your own t27 spec, how t27c compiles it, and how it becomes a bitstream on a real board.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · The chip

What an FPGA is, which chip we use, and how its pins meet the board.

+
+
01

Lesson 1 of 27

An FPGA is a grid you configure

+
+

You will learnWhat an FPGA is made of, and why a design uses only part of the chip.

A CPU runs instructions one after another. An FPGA has no program at all: it is a grid of small blocks -- lookup tables (LUTs), flip-flops, carry chains, block RAM and DSP multipliers -- joined by wires you can switch. Configuring the grid builds a circuit. Our bench chip is an AMD Artix-7 XC7A200T. The skyline draws one routed design on that die: every tile it configures stands up as a column, and most of the chip stays dark.

Try it

Rotate the die and tap the tallest column: which kind of tile sets the most features? In the spec frame of our bench board, find LUT_TOTAL, then the invariant on DSP48E1_TOTAL: what does its name say our cores use?

+
FASM skyline: a routed 7-series design as a city on the XC7A200T dieThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/boards/wukong_v1.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

Which chip is this?

+
+

You will learnHow a chip names itself in 32 bits, and how to read those bits.

Before you load anything, you ask the board which chip it has. Over JTAG every chip answers with a 32-bit IDCODE: a version, a part number, the manufacturer and a fixed 1 in bit 0. A bitstream built for the wrong part is refused by the chip, so this is the check that saves you an afternoon. The decoder splits the bits into those four fields and looks the part up in openFPGALoader's own table.

Try it

Click the bench preset, then flip one bit of the part number and see which device it would be. In the spec frame, the idcode-cfg action names the IDCODE a healthy XC7A100T returns: decode it and compare its part number with the bench chip's.

+
JTAG IDCODE decoder: 32 bits, four fields, one deviceThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/tri/fpga.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

Pins, balls and the package

+
+

You will learnHow the signals of your design reach the outside world.

A chip sits in a package: the XC7A200T on our board has 676 solder balls under it. Some carry power or configuration and only some are user IO, grouped into banks with their own voltage. A constraints file (XDC) says which ball each signal of your design uses. Put a signal on a ball that is not user IO and the build fails, or worse, the board does not do what you think.

Try it

Search for a ball name like E3, then colour by pin type and find a ball that is not user IO. The spec frame pins a small design to another package, the XC7A100T in CSG324: find the test that puts its clock on ball E3, and the one that counts its pins.

+
Pin map: the XC7A200T FGG676 package ball by ball, with an XDC lintThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/boards/xc7a100t_minimal.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · Numbers in hardware

Bits, trits and number formats, and what arithmetic costs in logic.

+
+
04

Lesson 4 of 27

Bits, trits and GF16

+
+

You will learnHow a number is stored in bits, and how balanced ternary stores it in trits.

Hardware stores numbers as fixed groups of bits, and t27 makes you write the width: u8 is 8 unsigned bits, i16 is 16 signed bits. t27 also speaks balanced ternary, where a trit is -1, 0 or +1. For fractions it has GF16, a 16-bit float with 1 sign bit, 6 exponent bits and 9 mantissa bits. Type a number into the calculator and watch how it is rounded, field by field, and how big the error is.

Try it

Type 1.618 and read the exponent and mantissa bits; then type 0.1 and look at the error.

+
GF16 calculator: a number as 16 GoldenFloat bits and as ternaryThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tutorial/01_values_and_types.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

What arithmetic costs

+
+

You will learnWhy a multiplier is expensive and an adder is cheap, measured on a real chip.

In logic, every operation has a price paid in chip resources. An adder is a carry chain, cheap and fast. A multiplier built from LUTs is large; the chip has DSP blocks made for multiplying, and a synthesizer uses them when it may. These curves are real yosys counts from 4 to 64 bits. Switch DSPs off and on, and see why hardware people care so much about the width of every number.

Try it

Pick Multiply, switch DSP48E1 to -nodsp, and compare the LUTs at 32 bits with and without DSPs.

+
Cost curves: adders, multipliers and MACs on a Xilinx 7-seriesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tutorial/05_widths_and_casts.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

How much fits on the chip

+
+

You will learnHow to read a resource count and find which resource runs out first.

A synthesis report says how many LUTs, flip-flops, DSPs and block RAMs your design takes. The question that matters is which of them runs out first. A design can use few LUTs and still not fit because it needs more DSPs than the chip has. Type a LUT count, or pick one of our real designs, and see how many copies fit on an XC7A200T.

Try it

Pick a real design, then raise the DSP count until something other than LUTs runs out first. In the spec frame, fits_board checks four resources in turn: which one comes last, and how many DSP48 blocks does xc7a100t_resources list?

+
Fits on a 200T: how many copies of your design an XC7A200T holdsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/stdlib.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · Your t27 program

Write a spec, test it, and see why compiling is not the same as being right.

+
+
07

Lesson 7 of 27

Hello, t27

+
+

You will learnWhat a t27 spec looks like, and what the compiler does with it in your browser.

A t27 program is a spec: a module with typed constants, functions and tests. Prose lines start with a semicolon at the start of a line. The player below runs the real t27 compiler, built to WebAssembly, inside your browser: it reads hello_world.t27, runs its tests and writes code for seven backends. Nothing is installed and nothing is sent anywhere. Open the tutorial spec under the widget and read it next to the output.

Try it

Run the tests in the player, then switch the backend and find the same function in two languages.

+
hello_world.t27, compiled inside the postThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tutorial/02_functions.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

Tests are part of the spec

+
+

You will learnWhy every t27 spec carries its own tests, and what a waveform shows.

In t27 a spec is not finished without its claims: test blocks, invariants and benches live in the same file as the code they check, and the compiler refuses a spec with none. A test can also be run as gates in a simulator. The waves below are a real simulation of Verilog generated from a ternary multiply-accumulate spec, driven by that spec's own test vectors.

Try it

Zoom into one clock cycle and read the values on the buses at a pass mark.

+
Test waves: a t27 spec's tests, simulated and drawn as wavesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tutorial/07_tests_invariants_benches.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Compiles is not the same as correct

+
+

You will learnWhy green checks are not proof, and how to catch code that compiles and is wrong.

A compiler that accepts your code only tells you the code is well formed. It does not tell you the code means what you meant. This recording shows a tool that found specs which compile, pass every gate and are still read wrongly. The lesson for hardware is sharper still: a bug in silicon cannot be patched. Plant a bug yourself in the mutation recording and watch the tests catch it.

Try it

Open the mutation recording under Also try and count how many planted bugs the tests caught.

+
tri misread: code that compiles and is wrongThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tutorial/03_operators.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · Inside t27c

How the compiler reads a spec and what it writes, including the native t27b.

+
+
10

Lesson 10 of 27

The stages of t27c

+
+

You will learnThe path a spec takes inside t27c: tokens, syntax tree, types, HIR, code.

t27c reads a spec in stages. The lexer cuts the text into tokens. The parser builds a syntax tree. The type checker checks every width and every call. The tree is lowered to HIR, a simpler form, and each backend writes code from it. This widget runs those stages on a spec in your browser and shows what each one produced, so an error has a stage you can point at.

Try it

Pick an example and step through the stages; find the stage where a type error would stop.

+
Inside t27c: watch a compiler read your code, stage by stageThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tutorial/06_structs_enums_switch.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

t27c on a real machine

+
+

You will learnThe same compiler on a real machine, printing what it really prints.

The player in lesson 7 runs the compiler in your browser. This recording is the native t27c, written in Rust, run on a real machine on the same hello_world.t27: it reports the spec's status, the tests and invariants it emits, and the Verilog module with its parameters. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find the line where t27c prints the Verilog module's parameters.

+
t27c on hello_world.t27The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/demos/hello_world.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

Seven backends, and t27b

+
+

You will learnOne spec, many target languages, and a native compiler with no LLVM.

One t27 spec can become Zig, C, Rust, JavaScript, TypeScript or Verilog; Verilog comes two ways, straight from the spec and through the HIR, which makes seven backends. The player shows the Rust t27c writes for hello_world. t27b is a second compiler: native AArch64 machine code, no LLVM, a JIT for tests and Mach-O object files. It is not finished, and we say how far it is: in run 26c447ad8 it passed 307 of the 449 specs that the reference compiler passes with tests, 68.4%.

Try it

Switch the player to JavaScript under Also try, generate the module, and run it.

+
hello_world.t27 to Rust, in a terminal inside the postThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tutorial/08_modules_and_arrays.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · From spec to hardware

The Verilog t27c writes, the cells it becomes, and what one LUT does.

+
+
13

Lesson 13 of 27

From a spec to Verilog

+
+

You will learnHow a t27 function becomes logic, and how a clocked function becomes registers.

Verilog is the text a synthesizer reads to build a circuit. t27c writes it from the spec. A function named on_clock becomes an always block on the clock edge, and every module var becomes a register with a reset. Open clocked_counter.t27 in the player: an 8-bit counter in a few lines, and the Verilog it turns into. Its header records what yosys built from it.

Try it

Open clocked_counter.t27 in the player and find the always block in its Verilog tab.

+
hello_world.t27 to Verilog, in a terminal inside the postThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/clocked_counter.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Count the cells

+
+

You will learnHow to count what a synthesizer built: LUTs, flip-flops, DSPs, block RAM.

After synthesis, yosys can print what it built as JSON: how many LUTs, flip-flops, DSPs and block RAMs. Those counts are an honest measure of a design before place and route. Paste a stat -json from yosys into the stat card, or open the real sample, and get a card and a README badge that say plainly that they are a synthesis count.

Try it

Open the real sample, then read the LUT and FF counts on the card.

+
Stat card: your yosys stat -json as a card and a README badgeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tutorial/04_control_flow.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

One LUT, up close

+
+

You will learnWhat a 6-input lookup table is, and how 64 bits describe any gate.

A LUT6 is a tiny memory with 6 address inputs and 64 one-bit entries. Any logic function of 6 inputs is just its truth table written into those 64 bits, the INIT value. Paste an INIT and the widget reads it back as a truth table and an expression. Then play the guessing game on LUTs taken from a real routed design: XOR, AND, a multiplexer, or something with no short name.

Try it

Try the XOR6 and majority examples, then play five rounds of Guess the gate. In the spec frame, full_adder is built from xor2 and maj3: which one makes the carry, and how many neurons does the spec say it takes?

+
LUT explain: a 7-series LUT6 INIT and its FASM line, read as logicThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/ternary_full_adder.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · Reading synthesis

What yosys reports about your design, and which warnings matter.

+
+
16

Lesson 16 of 27

Synthesis warnings that matter

+
+

You will learnHow to read a yosys log, and the warnings that become bugs on silicon.

yosys tells you a lot, and most of it is fine. A few lines are not: a latch you did not mean, a wire nothing drives, two drivers on one net, a memory that became flip-flops. Each of those works in simulation and fails on the chip. Open one of the real logs from t27 specs, then paste a log of your own.

Try it

Open each real log and find the one that yosys refused, and why. In the spec frame, a cross-module pass counts what it cleaned up: find the three counters of CrossOptPass and the test where they add up to 17.

+
Synth smells: a lint card for your yosys logThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/crossopt.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

State machines

+
+

You will learnHow a synthesizer finds a state machine in your design, or refuses to.

Many designs are state machines: a register that holds the current state and logic that picks the next one. yosys looks for them and, when it finds one, can re-encode it. When it refuses, it says why. The widget draws the graph yosys extracted from real designs, a UART receiver and a SPI flash master, and shows a case it refused.

Try it

Open the uart_rx sample and count its states and transitions. The JTAG port runs a state machine too: in the spec frame, find the test that says how many states the TAP controller has.

+
FSM sketch: the state machine yosys found in your RTLThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/dft.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

Where the LUTs go

+
+

You will learnWhich part of a design spends the LUTs, and why hierarchy matters.

A design is built from modules that contain modules. When yosys keeps the hierarchy, it counts each submodule once, and the instance counts tell you how many copies there are. The treemap multiplies them out and shows which submodule eats the LUTs. One adder used many times can cost more than everything else together.

Try it

Switch between the hierarchical and flattened totals and find the largest tile. In the spec frame, find fpga_util and the test that turns 31700 used LUTs into a share of one chip: what percent does it get?

+
LUT treemap: which submodule eats your LUTs, from yosys stat -jsonThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/partition.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · Place, route, timing

Where the cells land on the die, and whether the clock is met.

+
+
19

Lesson 19 of 27

Placement: where the cells land

+
+

You will learnWhat place and route does, and where it put a real design.

Synthesis says which cells you need. Place and route decides where each one sits on the die and which wires connect them. nextpnr-xilinx does both in the open flow. The map draws every placed cell of a real run on the XC7A200T: a small design is a small cluster in a huge chip.

Try it

Fit the design, then tap cells of different types and read their BEL names. In the spec frame, find RegionKind: which two of its five kinds are columns, and which test checks that a BRAM column is 1 wide?

+
Placement map: where nextpnr put every cell on the XC7A200TThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/placement.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

Logic depth

+
+

You will learnWhy the longest chain of logic sets how fast a design can run.

A signal needs time to pass through each LUT and each wire. The longest chain of logic between two registers sets how fast the clock can tick. yosys can show that chain as a count of cells, before any routing. The staircase draws it for a real GF16 adder, step by step.

Try it

Open the real sample and count how many steps of the path are LUTs. In the spec frame, est_comb_delay charges each LUT 100 ps plus 300 ps of routing: find the test that gets 600 for three LUTs.

+
LUT depth: your longest yosys path, drawn as a staircaseThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/timing.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

Timing and slack

+
+

You will learnWhat slack is, and how to read a timing report path by path.

Slack is how much time is left on a path when the clock period ends. Positive slack: the path is fast enough. Negative: the design fails at that clock. Each bar here is a real path from a routed design at 50 MHz, split into logic and routing, worst first. Find where the time goes on the worst path.

Try it

Click the worst path and compare its logic time with its routing time. In the spec frame, every clock_tree carries 100 ps of skew: find the test where a 50 ps budget fails, and the one where 200 ps passes.

+
Slack waterfall: every timing path of a routed design, worst firstThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/cts.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · The bitstream

How a routed design becomes the bits the chip loads, with no Vivado.

+
+
22

Lesson 22 of 27

From FASM to frames

+
+

You will learnWhat FASM is, and how features become configuration frames.

After routing, the design is a list of features to switch on, in a text format called FASM: this LUT has this INIT, this wire connects to that one. Tools from prjxray turn features into configuration frames, blocks of bits the chip loads. This recording does that step with t27's own tool and compares every frame with the reference tool: they are byte-identical.

Try it

Find where the recording says how many frames matched, out of how many. In the spec frame, HELP_LINE says what tri x7-fasm compares against fasm2frames: of its 20 entries, how many are real and how many must be refused?

+
tri x7-fasm · a bitstream assembled without VivadoThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/x7-fasm.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

A build, itemised

+
+

You will learnEvery stage from a spec to a bitstream, with its time, tool and hash.

A whole build from a t27 spec to an Artix-7 bitstream, written out like a shop receipt: each stage, the tool and its version, the time it took, and the sha256 of what it wrote. No Vivado anywhere. When a number on a receipt can be checked, anyone can rebuild it and compare the hash.

Try it

Read the receipt: which stage took the longest, and which tool ran it? In the spec frame, RECEIPT_KINDS names two kinds of receipt: which one is the build alone, and which entry in ERRORS catches it posing as the other?

+
Build receipt: t27 spec to XC7A200T bitstream, no VivadoThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/adapter.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

Read a bitstream

+
+

You will learnWhat is inside a .bit file, and which chip it was built for.

A .bit file is a header followed by packets: commands to the chip's configuration logic and the frames themselves. One of those commands writes the IDCODE of the chip the file was built for. Drop a .bit into the autopsy and see which chip it asks for. Five bitstreams committed to t27 turn out to target a different part than our bench.

Try it

Open the blink_j26 sample and compare the part in its header with the IDCODE it writes. In the spec frame, read HELP_LINE: against which reference tool is tri x7-writer byte-identical, and what kind of input does it refuse?

+
Bitstream autopsy: which FPGA a 7-series .bit really targetsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/x7-writer.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · On the board

Ask the chip who it is, load the bits, and check them.

+
+
25

Lesson 25 of 27

JTAG asks the chip

+
+

You will learnHow a cable finds the chip on a board and reads its IDCODE.

JTAG is the cable protocol for talking to the chip on a board. Before programming, the tool shifts out the IDCODE of every device on the chain. This recording decodes the codes our bench answers with, and shows what an even code means: no IDCODE at all. Compare it with the decoder from lesson 2.

Try it

Find which IDCODE belongs to an XC7A200T and which to an XC7A100T. In the spec frame, HELP_LINE says how tri fpga-jtag reads a chain with no answer: what does it blame for all ones, and what for all zeros?

+
tri fpga-jtag · which chip answered the cableThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/fpga-jtag.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

The same bits, on the board

+
+

You will learnHow to show that a bitstream is byte-identical and that it runs.

The claim most FPGA people doubt: a bitstream built by an open flow from t27 specs, byte-identical to the reference toolchain, and working on a real board. This recording compares the files, loads the bits into the chip's SRAM and counts the receipts the board sends back. Drop two .bit files into bit-diff to check the byte-identical part yourself.

Try it

Wait for the receipts count at the end, then try bit-diff under Also try. In the spec frame, ACTIONS lists the steps of tri x7-board: which one loads the chip's SRAM, and which flag does HELP_LINE say it needs?

+
A bitstream from t27 specs, run on the AX7203The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/x7-board.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

Capstone: out-guess yosys

+
+

You will learnPut it together: guess what a real t27 module costs in LUTs.

Everything from this course in one game. Each day Gatle shows one real t27 module and the Verilog your browser compiles from it; you have six guesses at how many LUTs yosys spent on it. Use what you know: widths, multipliers, hierarchy, state. Then look at the other ways people and agents compete on t27.

Try it

Play today's puzzle. Then read the module's Verilog and say why it cost what it did. Run the tests in the spec frame: how many of the 12 instructions in hello_kernel are GF16 operations, and which test says all 12 take 48 bytes?

+
Gatle: guess how many LUTs yosys spends on today's t27 moduleThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/e2e_demo.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · The chip
    1. 01 An FPGA is a grid you configure
    2. 02 Which chip is this?
    3. 03 Pins, balls and the package
  2. 02 · Numbers in hardware
    1. 04 Bits, trits and GF16
    2. 05 What arithmetic costs
    3. 06 How much fits on the chip
  3. 03 · Your t27 program
    1. 07 Hello, t27
    2. 08 Tests are part of the spec
    3. 09 Compiles is not the same as correct
  4. 04 · Inside t27c
    1. 10 The stages of t27c
    2. 11 t27c on a real machine
    3. 12 Seven backends, and t27b
  5. 05 · From spec to hardware
    1. 13 From a spec to Verilog
    2. 14 Count the cells
    3. 15 One LUT, up close
  6. 06 · Reading synthesis
    1. 16 Synthesis warnings that matter
    2. 17 State machines
    3. 18 Where the LUTs go
  7. 07 · Place, route, timing
    1. 19 Placement: where the cells land
    2. 20 Logic depth
    3. 21 Timing and slack
  8. 08 · The bitstream
    1. 22 From FASM to frames
    2. 23 A build, itemised
    3. 24 Read a bitstream
  9. 09 · On the board
    1. 25 JTAG asks the chip
    2. 26 The same bits, on the board
    3. 27 Capstone: out-guess yosys
+ + + + + diff --git a/apps/website/public/learn/course/index.html b/apps/website/public/learn/course/index.html index 08d57667a3..74d7f6830b 100644 --- a/apps/website/public/learn/course/index.html +++ b/apps/website/public/learn/course/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

From zero to a chip: FPGA programming with t27

No hardware background needed. Every lesson opens a real tool built from real runs on our bench: read a little, then try it yourself.

27 lessons, one working widget and one t27 spec each: what an FPGA is, how numbers become bits, your own t27 spec, how t27c compiles it, and how it becomes a bitstream on a real board.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/coverage-lies/index.html b/apps/website/public/learn/coverage-lies/index.html index ed22a2e567..584bf1f1cd 100644 --- a/apps/website/public/learn/coverage-lies/index.html +++ b/apps/website/public/learn/coverage-lies/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Coverage lies

You will learn

Why a coverage number can be a check that checked nothing, and how to spot it.

A coverage percentage is a claim about the tests, and claims can be empty. The widget found the empty kind: 11 specs refused at parse, 0 blocked only by prose, and 23 broken on purpose as fixtures -- but elsewhere in the corpus a 'test' that is only prose passes every check while executing nothing. The tells are always the same: a number with no denominator, a pass with no assert that ran, a sweep that cannot fail. Ask of every percentage: what would make this number move?

Try it

In the prose sweep, find the difference between 'refused at parse' and 'blocked only by prose'; then write a test whose pass executes no assert.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri prose report: prose, or code?
tri prose report: prose, or code? ↗

11 specs refused at parse, 0 blocked only by prose, 23 broken on purpose as fixtures.

specs/fpga/testbench/fifo_tb.t27

// FIFO testbench spec
@@ -302,6 +334,7 @@ 

Coverage lies

}

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/create-clock/index.html b/apps/website/public/learn/create-clock/index.html index 132da40fdb..f3a55d8b1f 100644 --- a/apps/website/public/learn/create-clock/index.html +++ b/apps/website/public/learn/create-clock/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

create_clock

You will learn

What the create_clock line tells the analyzer, and which spec writes it.

Until a create_clock line exists, the analyzer sees no clock at all and times nothing: every path is unconstrained and every report is empty. The line names the port, the period and the waveform edges. emitter_xdc.t27 is the spec of the emitter that writes such lines from a pins spec -- its text carries create_clock -add -name among the lines it emits. The native test-report on this spec is blocked in the current tree, so the recording shows what does run: t27c parse of the spec, clean, and the grep that finds its create_clock lines. The player compiles the spec in your browser.

Try it

In the recording, find the create_clock lines the grep returns; then in the spec frame find the emitter's line builder and say what a missing create_clock does to a timing report.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on emitter_xdc.t27 -- the XDC emitter, parsed
t27c on emitter_xdc.t27 -- the XDC emitter, parsed ↗

The pins-to-XDC emitter spec through t27c 0.4.0: the head of its AST and the create_clock lines it exists to write. Native test-report is blocked on this spec; parse is clean.

specs/pins/emitter_xdc.t27

// SPDX-License-Identifier: Apache-2.0
@@ -362,6 +394,7 @@ 

create_clock

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/cross-entropy/index.html b/apps/website/public/learn/cross-entropy/index.html index e8057b4095..474ea1a6a0 100644 --- a/apps/website/public/learn/cross-entropy/index.html +++ b/apps/website/public/learn/cross-entropy/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Cross-entropy

You will learn

Why cross-entropy charges a confident wrong answer so much, and why that is what trains a classifier.

A classifier outputs a probability, and cross-entropy charges -log of the probability it gave to the true answer. Predictions 0.8, 0.3 and 0.9 against answers 1, 0 and 1 cost 0.2284 on average. Being sure and right is nearly free: 0.99, 0.01 and 0.99 cost 0.0101. Being sure and wrong is expensive: 0.01, 0.99 and 0.01 cost 4.6052, and toward 0 the cost grows without bound, which is why the spec clips p to [1e-7, 1 - 1e-7]. Its gradient is largest exactly where the model is sure and wrong. The spec binary_crossentropy_loss.t27 computes the loss and the gradient, from probabilities or from logits.

Try it

Drag prediction 0 toward 0.01 and watch the curve; then read the gradient bars at 0.5, 0.5 and 0.5.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Cross-entropy: why a confident wrong answer costs so much
Cross-entropy: why a confident wrong answer costs so much ↗

Set three predicted probabilities against the answers 1, 0, 1: the loss is -log of the chance given to the truth. Drag toward a confident mistake and the cost climbs without bound.

specs/ml/loss/binary_crossentropy_loss.t27

// SPDX-License-Identifier: Apache-2.0
@@ -282,6 +314,7 @@ 

Cross-entropy

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/debug-with-waves/index.html b/apps/website/public/learn/debug-with-waves/index.html index 0534c92a06..7b6aefb26e 100644 --- a/apps/website/public/learn/debug-with-waves/index.html +++ b/apps/website/public/learn/debug-with-waves/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Debug with waves

You will learn

How to go from a symptom to a signal, cycle by cycle, on a real measured bug.

Here is a bug found with waves, end to end. A UART link on the bench requested 115,200 baud and the wire carried 115,385 -- a +0.16 % error from the clock divider, invisible in code, obvious in a capture. Requested 921,600, the wire carries 923,077, the same fractional error; 3,000,000 divides exactly and is exact on the wire. The measurement names the fix: choose divisors that land on integers. Waves turn a symptom (bytes lost) into a number (0.16 %) into an edit.

Try it

Compute what divider would put 115,200 on the wire exactly; check it against the 921,600 and 3,000,000 rows in the widget.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-wire · the baud rate actually on the wire
tri fpga-wire · the baud rate actually on the wire ↗

CP2102N on a direct USB port, no hub. Requested 115,200 puts 115,385 on the wire (+0.16 %), 921,600 puts 923,077 (+0.16 %), 3,000,000 is exact.

specs/fpga/testbench/vcd_trace_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -159,6 +191,7 @@ 

Debug with waves

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/decode-in-one-step/index.html b/apps/website/public/learn/decode-in-one-step/index.html index 066fe75a30..b3e63fa9a1 100644 --- a/apps/website/public/learn/decode-in-one-step/index.html +++ b/apps/website/public/learn/decode-in-one-step/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Decode in one step

You will learn

Why a fixed-field format decodes its fields in parallel and a posit cannot, as the spec counts the steps.

A posit packs a regime of variable length before its exponent, so a decoder must find where the regime ends before it can read anything else. GF16 and IEEE FP16 keep every field at a fixed position, so all fields decode at once. gf_competitive.t27 counts the steps: 3 for FP16, 6 for POSIT16, 3 for GF16, and marks which can run in parallel. These are counts written into the spec, not a timing measured on hardware.

Try it

Find decode_complexity and the three entries it returns. Then find the invariant that compares the posit with GF16, and say what a timing on hardware would add.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 27: decode in one step
GoldenFloat 27: decode in one step ↗

Decode steps as gf_competitive.t27 counts them, read from gf_competitive.t27. Lesson 27 of the GoldenFloat course.

specs/math/gf_competitive.t27

// SPDX-License-Identifier: Apache-2.0
@@ -189,6 +221,7 @@ 

Decode in one step

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/depth-sizing/index.html b/apps/website/public/learn/depth-sizing/index.html index 799e5e73cc..2916ddad38 100644 --- a/apps/website/public/learn/depth-sizing/index.html +++ b/apps/website/public/learn/depth-sizing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Sizing the depth

You will learn

How depth follows from the write rate, the read rate and the worst burst, and what a real timed loop measures.

Depth is not a feeling: writes at rate W, reads at rate R, and the buffer must hold the worst burst times (W - R) over the time it lasts. Oversize it and it costs BRAM you could have spent; undersize it and it overflows silently, because a full FIFO drops or blocks and neither shows up in a waveform. The widget is a real loop with a measured time -- 19.06 s for router1, bitwalk, xc7frames2bit and the SRAM load, on a laptop at load average about 110 -- the same arithmetic of rate and time that sizes a buffer, measured on a run that really happened. The spec frame opens fifo.t27, whose fill_count is the number this lesson is about.

Try it

In the widget, find the loop's measured time and the load average it ran at; then in the spec frame find fill_count and write the depth formula for your own worst burst.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri competitors audit: the table, audited
tri competitors audit: the table, audited ↗

168 records: 14 papers entered twice, 141 cite no score, 144 state zero at pass@1.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Sizing the depth

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/designing-taps/index.html b/apps/website/public/learn/designing-taps/index.html index 1df78a53e2..74fdc59097 100644 --- a/apps/website/public/learn/designing-taps/index.html +++ b/apps/website/public/learn/designing-taps/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Designing taps

You will learn

How a windowed-sinc low-pass is designed, and what rounding its taps to integers costs.

The ideal low-pass is a sinc; cut it to a finite number of taps and multiply by a window, and a stopband appears. With 31 taps and a cutoff of 0.1, no window leaves the stopband from 0.2 at -32.8 dB; Hamming takes it to -62.6 dB and Blackman to -76.1 dB. Then the taps become integers: at 16 bits the Hamming stopband barely moves, at 8 bits it climbs back to -32.8 dB. The spec signals.t27 designs the taps and computes both responses.

Try it

Switch between the three windows at 31 taps; then lower the coefficient bits until the bits, not the window, set the stopband.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Designing FIR taps: a window, a cutoff, and the bits you keep
Designing FIR taps: a window, a cutoff, and the bits you keep ↗

Set taps, cutoff, window and coefficient bits. Watch the integer taps and the response: a better window deepens the stopband, too few bits fill it back in.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Designing taps

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/directed-vs-random/index.html b/apps/website/public/learn/directed-vs-random/index.html index 5fdb4bae0b..aed2b1e7c2 100644 --- a/apps/website/public/learn/directed-vs-random/index.html +++ b/apps/website/public/learn/directed-vs-random/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Directed versus random

You will learn

When one carefully chosen case beats a thousand random ones, and when it does not.

A directed test is one case you chose because you know it bites: the empty FIFO, the full one, the wrap. A random one is cheap volume. They are not rivals; they are a sequence. The widget is the knockout experiment turned into a tool: three performance bits were claimed, and one knockout bitstream per bit -- the same design with that bit tied off -- proves each one matters. That is directed testing's whole argument: one bit, one prediction, one bitstream, measured.

Try it

Pick one performance bit in the knockout widget and say what the no-knockout run would have to show for the bit to be a lie.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Three PERF2 bits, and one knockout bitstream per bit
Three PERF2 bits, and one knockout bitstream per bit ↗

The A/B bitstreams differ in three bits. Each knockout clears one: 3 bytes from the working .bit.

specs/fpga/testbench/uart_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -464,6 +496,7 @@ 

Directed versus random

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/does-it-fit-and-close-timing/index.html b/apps/website/public/learn/does-it-fit-and-close-timing/index.html index eabdc6705a..f3a3908cc4 100644 --- a/apps/website/public/learn/does-it-fit-and-close-timing/index.html +++ b/apps/website/public/learn/does-it-fit-and-close-timing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Does it fit and close timing?

You will learn

How to budget DSP slices for a multichannel filter, and why the adder tree, not the multiplier, misses timing.

Sixteen channels of a 63-tap symmetric filter at 50 MHz on a 250 MHz clock take 7 slices each, 112 of the 740 on an XC7A200T. Whether it closes timing is a question about one register-to-register path: a direct adder tree puts ceil(log2 63) = 6 adders in it, a systolic chain through the slice cascade puts one. With the delays you set, the tree misses a 4000 ps period and the chain makes it. The spec signals.t27 counts; the timing report of your build measures.

Try it

Load the adder-tree preset, switch it to the systolic chain and read the slack; then find how many channels of the 127-tap filter fit.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Does it fit, and does it close timing?
Does it fit, and does it close timing? ↗

Set a filter, its rates and a channel count: watch the 740 DSP slices of an XC7A200T fill, and a register-to-register path race the clock period.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Does it fit and close timing?

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/dropout/index.html b/apps/website/public/learn/dropout/index.html index 23e11c34f5..38ccbc87c8 100644 --- a/apps/website/public/learn/dropout/index.html +++ b/apps/website/public/learn/dropout/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Dropout

You will learn

Why switching units off while training helps, and why the survivors must be scaled.

While training, dropout switches off a share p of the units at random, so the rest cannot lean on any one of them. The units that survive must then be scaled, or the next layer would see the signal at another size in training than at inference. Inverted dropout scales them by 1 / (1 - p) while training: with p = 0.5, input 1, 2, 3, 4 becomes 2, 0, 6, 0, and inference is a plain pass. Classic dropout keeps 1, 0, 3, 0 and scales by 0.5 at inference instead. The spec dropout_layer.t27 uses a fixed mask, keep, drop, keep, drop, so the numbers are the same every time.

Try it

Compare the outputs of the four modes; then read the gradient of a dropped unit in training.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Dropout: training a network with neurons switched off
Dropout: training a network with neurons switched off ↗

Switch between training and inference, inverted and classic dropout: units 1 and 3 are dropped, the survivors are scaled so that the layer's output keeps its expected size.

specs/ml/layers/dropout_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -201,6 +233,7 @@ 

Dropout

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/elu/index.html b/apps/website/public/learn/elu/index.html index 600886bea4..89c07cae80 100644 --- a/apps/website/public/learn/elu/index.html +++ b/apps/website/public/learn/elu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

ELU: a floor, not a cliff

You will learn

How ELU keeps a soft negative side with a floor at -alpha, and why its slope never quite dies.

ELU keeps the positive side of ReLU and replaces the cliff on the negative side with alpha (e^x - 1), a curve that flattens toward -alpha. With alpha 1, x = -3 gives -0.9502, already near the floor of -1, and the slope there is 0.0498: small, but not 0, so the unit can still move. Because the negative outputs are not thrown away, a layer's outputs average closer to 0. The spec elu_activation.t27 computes the curve, the slope and the floor, and its own batch at -1, 0 and 2: -0.632, 0 and 2.

Try it

Set alpha to 0.5 and read the floor; then find how far left x must go before the slope is under 0.01.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

ELU: a negative side with a floor
ELU: a negative side with a floor ↗

Drag along ELU: x above zero, alpha (e^x - 1) below. The negative side never falls under -alpha, so outputs average closer to zero, and its slope never quite dies.

specs/ml/activation/elu_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -190,6 +222,7 @@ 

ELU: a floor, not a cliff

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/embeddings/index.html b/apps/website/public/learn/embeddings/index.html index f2239df525..d2feaa869d 100644 --- a/apps/website/public/learn/embeddings/index.html +++ b/apps/website/public/learn/embeddings/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Embeddings

You will learn

How a token becomes a row of numbers, and why learning changes only the rows that were read.

A network cannot multiply a word, so each token is an index into a table with one row of numbers per token, and looking a token up copies its row. In the spec the table has 4 tokens of width 2 and row v holds (10 v, 10 v + 1), so token 2 reads (20, 21). Learning sends the gradient back only to the rows that were read, and a token read twice collects both: gradient rows (1, 2) and (3, 4) on token 2 add up to (4, 6). The spec embedding_layer.t27 computes the lookup and the gradient.

Try it

Read token 2 twice and then tokens 1 and 3; count the rows whose gradient is not 0 each time.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Embeddings: how a word becomes a row of numbers
Embeddings: how a word becomes a row of numbers ↗

Pick two tokens: each one copies its row out of the table. Then the gradient flows back only into the rows that were read, and a token read twice collects both.

specs/ml/layers/embedding_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -233,6 +265,7 @@ 

Embeddings

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/end-to-end-scenarios/index.html b/apps/website/public/learn/end-to-end-scenarios/index.html index 527163a184..c689bfe29d 100644 --- a/apps/website/public/learn/end-to-end-scenarios/index.html +++ b/apps/website/public/learn/end-to-end-scenarios/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

End-to-end scenarios

You will learn

How a scenario walks a whole flow, and what an end-to-end run proves that units cannot.

Unit tests prove the pieces; a scenario proves the pipe. The lesson's spec, e2e_demo, walks one design from spec to board in a single run, so a failure anywhere in the chain fails one place with a name. The widget draws the whole FPGA flow one layer per line -- spec, Verilog, cells, placement, bitstream, board -- and an end-to-end scenario is exactly that picture as a test: every layer either produces its artefact or stops the run.

Try it

Walk the flow widget layer by layer and say what artefact each layer must produce; then find in e2e_demo where a missing artefact stops the run.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri devkit · the FPGA flow, layer by layer
tri devkit · the FPGA flow, layer by layer ↗

One real XC7A200T build: 116.9 s with openXC7, 83.5 s with t27 L3+L4, byte-identical. Place & route is 60%.

specs/fpga/e2e_demo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -320,6 +352,7 @@ 

End-to-end scenarios

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/enough-reviewers/index.html b/apps/website/public/learn/enough-reviewers/index.html index 50396a40a0..be180a6798 100644 --- a/apps/website/public/learn/enough-reviewers/index.html +++ b/apps/website/public/learn/enough-reviewers/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Enough reviewers

You will learn

How many reviews must run at once for the reviewer to keep up with the bees.

A review may take REVIEW_ROW_SECONDS, 300 s, so one slot clears at most 12 rows an hour. On 2026-10-09 bees finished about 58 an hour while 111 rows waited, and the fixed REVIEWER_CONCURRENCY of 4 tops out at 48. slots_needed(58) is 5. reviewer_concurrency takes the keys, their lanes and the free memory, never goes above 16 and never below 1 while anything waits, and keeps_up compares it with the finish rate.

Try it

Find the fewest keys of 1 lane that keep up with 58 an hour; then cut the memory to 1000 MB.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

How many reviewer bees: keeping up with the finish rate
How many reviewer bees: keeping up with the finish rate ↗

Set the keys, lanes, memory and the rows waiting: reviewer_concurrency says how many reviews run at once, and keeps_up says whether that outruns the bees finishing work.

specs/queen/reviewer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -383,6 +415,7 @@ 

Enough reviewers

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/enums/index.html b/apps/website/public/learn/enums/index.html index 17cf3edc1c..3af91558e9 100644 --- a/apps/website/public/learn/enums/index.html +++ b/apps/website/public/learn/enums/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Enums

You will learn

The two ways to declare an enum and how a switch reads a value.

pub enum Color { Red, Green, Blue } names three cases. The Zig form pub const Mode = enum(u8) { Idle, Run } also fixes the type that stores a case, here u8. A switch over a value lists what each case gives and uses else for the rest. Both forms compile clean on all 7 backends in the lesson spec.

Try it

Add a fourth color to Color and update CASES_IN_COLOR so the test passes.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 18: two ways to write an enum
t27 basics 18: two ways to write an enum ↗

The two enum forms the t27 compiler accepts, side by side with their cases. Lesson 18 of the t27 basics course.

specs/basics/18_enums.t27

// SPDX-License-Identifier: Apache-2.0
@@ -90,6 +122,7 @@ 

Enums

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/everything-in-one-bench/index.html b/apps/website/public/learn/everything-in-one-bench/index.html index 889697c279..362f31a41f 100644 --- a/apps/website/public/learn/everything-in-one-bench/index.html +++ b/apps/website/public/learn/everything-in-one-bench/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Everything in one bench

You will learn

What an integration bench checks when every bus of the design is driven at once.

An integration bench drives every bus at once and asks the design to hold together: test_reset_all_modules, test_module_count, test_mac_uart_pipeline, test_spi_memory_pipeline, test_full_pipeline, seven tests. The recording lowers the integration testbench spec to Verilog: every bus of the design in one bench.

Try it

In the recording, find the five pipeline tests; then in the spec frame say which two buses the integration bench joins.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on integration_tb.t27 -- the integration bench
t27c gen-verilog on integration_tb.t27 -- the integration bench ↗

The integration testbench spec lowered to Verilog: every bus of the design in one bench.

specs/fpga/testbench/integration_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -200,6 +232,7 @@ 

Everything in one bench

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/expressions/index.html b/apps/website/public/learn/expressions/index.html index 8a0b61467c..a5bad517f4 100644 --- a/apps/website/public/learn/expressions/index.html +++ b/apps/website/public/learn/expressions/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Expressions

You will learn

Arithmetic operators and comparisons on the lesson constants, and the bool a comparison gives back.

An expression combines names and numbers with operators. With A = 17 and B = 5, A + B is 22, A - B is 12, A * B is 85, A / B is 3 because whole numbers divide without a fraction, and A % B is 2, the remainder. Comparisons give true or false. One limit of the test runner on this site: it does not read a minus sign in front of a number, so write negative values as constants.

Try it

Change B to 4 and predict each of the five results before you run the tests.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 9: operators on two numbers
t27 basics 9: operators on two numbers ↗

Every arithmetic and comparison operator of a t27 test, applied to 17 and 5 by the lesson spec. Lesson 9 of the t27 basics course.

specs/basics/09_expressions.t27

// SPDX-License-Identifier: Apache-2.0
@@ -90,6 +122,7 @@ 

Expressions

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/false-path-and-max-delay/index.html b/apps/website/public/learn/false-path-and-max-delay/index.html index 79cc55b72e..c59f75552c 100644 --- a/apps/website/public/learn/false-path-and-max-delay/index.html +++ b/apps/website/public/learn/false-path-and-max-delay/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

False paths and max delay

You will learn

What a false path declares, what a max delay bounds instead, and what removing a check looks like in a repository.

set_false_path tells the analyzer a crossing is asynchronous: stop reporting it, the synchronizer owns it. Used beyond that, it silences real failures, so a CDC flow pairs it with set_max_delay, which bounds a synchronizer path instead of ignoring it -- the two or three flops must still be close in time. A false path is a check deliberately removed, and the widget shows what removing checks looks like in a repository: 14 days of merged pull requests, which added tests, changed them or removed asserts, with the exact lines from git. The spec frame opens timing.t27, the analysis the exceptions carve holes in.

Try it

In the widget, find a pull request that removed asserts and the exact lines it took; then in the spec frame find the slack arithmetic a false path silences.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-txhold: setup and hold from the routed SDF
tri fpga-txhold: setup and hold from the routed SDF ↗

Smallest hold 3445 ps on TXD1 against a 1000 ps bench; each TX pin's setup and hold from nextpnr's own SDF of the routed node.

specs/fpga/timing.t27

// SPDX-License-Identifier: Apache-2.0
@@ -446,6 +478,7 @@ 

False paths and max delay

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/fasm-to-frames/index.html b/apps/website/public/learn/fasm-to-frames/index.html index 54e1c254f7..e4f86fc680 100644 --- a/apps/website/public/learn/fasm-to-frames/index.html +++ b/apps/website/public/learn/fasm-to-frames/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

From FASM to frames

You will learn

What FASM is, and how features become configuration frames.

After routing, the design is a list of features to switch on, in a text format called FASM: this LUT has this INIT, this wire connects to that one. Tools from prjxray turn features into configuration frames, blocks of bits the chip loads. This recording does that step with t27's own tool and compares every frame with the reference tool: they are byte-identical.

Try it

Find where the recording says how many frames matched, out of how many. In the spec frame, HELP_LINE says what tri x7-fasm compares against fasm2frames: of its 20 entries, how many are real and how many must be refused?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri x7-fasm · a bitstream assembled without Vivado
tri x7-fasm · a bitstream assembled without Vivado ↗

FASM to frames: 22 of 22 byte-identical to fasm2frames, ours 6.31 s in this run (fasm2frames took 150.7 s at corpus build). Frames to .bit: 16 of 16 byte-identical to xc7frames2bit; a wrong-part input is refused.

specs/tools/trios/tri/x7-fasm.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

From FASM to frames

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/fifo-testbench/index.html b/apps/website/public/learn/fifo-testbench/index.html index fc695debc3..bba4b4d2e8 100644 --- a/apps/website/public/learn/fifo-testbench/index.html +++ b/apps/website/public/learn/fifo-testbench/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The FIFO testbench

You will learn

What a testbench discipline looks like when it is real, and why this lesson opens the FIFO spec and a mutation recording instead.

A testbench for the asynchronous FIFO would drive both clocks, tear the pointers on purpose and check that the flags never lie. The testbench spec in this tree is not that yet: it does not compile in the browser compiler and native runs are blocked on it, so this lesson opens fifo.t27 itself and, in place of a FIFO testbench, a recording of the discipline it would follow: 5 planted bugs in packets.t27 -- a CRC polynomial bit, a CRC address width, LFRM no-ops, a COR0 bit, a type-2 word count -- each mutant rebuilt and re-swept, every one caught. When a real testbench spec lands, this lesson takes it.

Try it

In the recording, list the 5 planted bugs and count how many were caught; then in the spec frame find the flags a real testbench would have to tear on purpose.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri discard top: what the parser throws away
tri discard top: what the parser throws away ↗

67 specs lose 23,578 tokens to parser recovery, each held at its pinned bound.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

The FIFO testbench

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/five-channels/index.html b/apps/website/public/learn/five-channels/index.html index 340a767897..6ea90fcb97 100644 --- a/apps/website/public/learn/five-channels/index.html +++ b/apps/website/public/learn/five-channels/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Five channels

You will learn

What the five AXI4 channels carry, and what the compiler emits for them.

AXI4 carries five independent channels: write address, write data, write response, read address, read data. The spec states the widths -- AXI_ADDR_WIDTH 32, AXI_DATA_WIDTH 32, AXI_STRB_WIDTH 4, AXI_ID_WIDTH 4, AXI_LEN_WIDTH 8, AXI_SIZE_WIDTH 3 -- under a MAX_BUS_PORTS of 32. The recording lowers the AXI4 spec to synthesizable Verilog: the channels' wiring and handshakes as generated wires.

Try it

In the recording, find the channels in the emitted wires; then in the spec frame list the six AXI widths and say what the 8-bit LEN covers.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on axi4.t27 -- spec to RTL
t27c gen-verilog on axi4.t27 -- spec to RTL ↗

The AXI4 spec lowered to synthesizable Verilog: the five channels' wiring and handshakes as generated wires.

specs/fpga/axi4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -461,6 +493,7 @@ 

Five channels

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/five-rules-for-weights/index.html b/apps/website/public/learn/five-rules-for-weights/index.html index 5cc9f74640..b7f76ad326 100644 --- a/apps/website/public/learn/five-rules-for-weights/index.html +++ b/apps/website/public/learn/five-rules-for-weights/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Five rules for a weight alphabet

You will learn

What values a ternary weight may take, how five measured rules leave one formula, and what a sixth rule removes from it.

The spec golden_sieve.t27 gives a ternary weight five measured rules and a sixth that narrows what they leave. S1: the number of values is a power of three; S2: at most two trits, as a third gave no significant gain. S3: one accumulator lane, so any two weights have a rational ratio: plus and minus phi pass as a common scale, while 1 and phi need two lanes. S4: at most six input bits per neuron, a trade, not a law, says the spec; S5: no DSP48E1 or SRL16E cells, for which openXC7 wrote a wrong bitstream while every tool said OK. The five leave TNF(k, b) with 3 or 9 levels, and S6 removes the 9-level form: on every integer ladder the top weight outweighs the others added, so one input decides. The browser runs all 3 tests and all 8 invariants.

Try it

Run the tests; then change MAX_TRITS to 3 in the source and see which two checks fail. In the spec frame, trits size a float exponent, not a weight: find exp_values of tnf4 and the test that says which offset is not finite.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

golden_sieve.t27, the ternary sieve, compiled inside the post
golden_sieve.t27, the ternary sieve, compiled inside the post ↗

The Golden Sieve as a t27 spec: five predicates a ternary weight alphabet must pass, compiled by t27c as WebAssembly in your browser. Seven backends; every test runs in the page.

specs/numeric/tnf4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -115,6 +147,7 @@ 

Five rules for a weight alphabet

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/five-trits-a-byte/index.html b/apps/website/public/learn/five-trits-a-byte/index.html index 496b601140..2394543236 100644 --- a/apps/website/public/learn/five-trits-a-byte/index.html +++ b/apps/website/public/learn/five-trits-a-byte/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Five trits in a byte

You will learn

How 3^5 = 243 fits under 2^8 = 256, and what the 13 spare codes mean.

Five trits have 243 combinations and a byte has 256, so five trits fit one byte with 13 codes to spare. The spec packs them as a number in base 3, each trit plus one, and unpacks with division. That uses 99.06% of the byte's information against 79.25% for two bits per trit. Bytes from 243 up are not codes at all.

Try it

Pack +1 +1 +1 +1 +1 and read the byte; then set the byte to 243 and explain what the widget says.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Five trits in one byte: 243 of 256 codes
Five trits in one byte: 243 of 256 codes ↗

3^5 = 243 fits under 2^8 = 256. Press the trits to pack them, or drag the byte to unpack it; bytes from 243 up hold nothing.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Five trits in a byte

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/flip-and-cut/index.html b/apps/website/public/learn/flip-and-cut/index.html index db3c1a18ed..095ea7b4e6 100644 --- a/apps/website/public/learn/flip-and-cut/index.html +++ b/apps/website/public/learn/flip-and-cut/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Flip to negate, cut to round

You will learn

Why negation is a flip of every trit and truncation is already rounding.

In two's complement, negating means inverting and adding one; in balanced ternary you only flip every trit, and the spec's negate() does exactly that, place by place. Cutting the lowest k trits leaves the nearest multiple of 3^k: 8 cut by one trit is 9, 7 is 6. No tie can happen, because the dropped part is always less than half a step, so balanced ternary needs no rounding rule.

Try it

Press flip on 8 and on -121; then cut 13 by one and by two trits and check each result against the nearest multiple.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Flip every trit to negate, cut trits to round
Flip every trit to negate, cut trits to round ↗

Negation in balanced ternary flips every trit: no borrow, no complement. Cutting the lowest trits rounds to the nearest multiple.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Flip to negate, cut to round

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/folding-taps-onto-slices/index.html b/apps/website/public/learn/folding-taps-onto-slices/index.html index be6e16eca6..e3269f8703 100644 --- a/apps/website/public/learn/folding-taps-onto-slices/index.html +++ b/apps/website/public/learn/folding-taps-onto-slices/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Folding taps onto slices

You will learn

How symmetry and a fast clock cut the DSP slices a FIR needs.

A linear-phase FIR has symmetric taps, so the DSP48E1 pre-adder can add the two samples that share a tap and multiply once: 31 taps need 16 multipliers. A slice clocked C times per sample can run C of them one after another, so at 50 MHz on a 200 MHz clock 4 slices do the work, and at 48 kHz one slice does it all. The XC7A200T has 740 slices. The spec signals.t27 assigns every tap to its slice.

Try it

Compare 31 taps at 50 MHz with and without symmetry; then raise the sample rate until each slice serves one multiplier.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Folding a FIR onto DSP slices
Folding a FIR onto DSP slices ↗

Set taps, symmetry, clock and sample rate. Symmetric taps share a multiplier; a fast clock lets one slice serve many taps. See how many slices are left.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Folding taps onto slices

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/four-trit-exponent/index.html b/apps/website/public/learn/four-trit-exponent/index.html index 91859a4c7f..e0b82e7cd6 100644 --- a/apps/website/public/learn/four-trit-exponent/index.html +++ b/apps/website/public/learn/four-trit-exponent/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A float whose exponent is four trits

You will learn

How TNF17e packs a sign, a ternary exponent and a mantissa into 17 bits, and why 17 and not 16.

The name TNF covers two different things. In the sieve, TNF(k, b) is an alphabet of weights with 3 or 9 levels. TNF17e in tnf17.t27 is a Ternary Network Float, which the spec calls the signed accumulator format: a sign bit, a 7-bit offset and a 9-bit mantissa, worth (-1)^s x (1 + m/512) x 2^(offset - 40). Its trits are in the exponent, not in the weights: the offset takes 81 values, exactly 3^4, so the exponent is four balanced trits, from -40 to +40. Four trits cost 7 bits on a binary chip, so the rung is 17 bits, not 16; the spec records that its source counted positions, and a trit is not a bit. The browser runs 20 of its 44 checks, all 10 invariants among them, and names the cast behind each skip.

Try it

Read the reason on one skipped test; then find the invariant that says four trits span 81 values. In the spec frame, tnf16 has four exponent trits too and sums to 16: find width_rule and read whether that 16 counts bits or positions.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tnf17.t27, a 17-bit ternary-exponent float, compiled inside the post
tnf17.t27, a 17-bit ternary-exponent float, compiled inside the post ↗

TNF17e as a t27 spec: a sign, a 7-bit offset holding four balanced trits, a 9-bit mantissa, compiled by t27c in your browser. Seven backends; every test the page cannot run says why.

specs/numeric/tnf16.t27

// SPDX-License-Identifier: Apache-2.0
@@ -140,6 +172,7 @@ 

A float whose exponent is four trits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/fpga-is-a-grid/index.html b/apps/website/public/learn/fpga-is-a-grid/index.html index 194c756ef3..1a8ef40f3c 100644 --- a/apps/website/public/learn/fpga-is-a-grid/index.html +++ b/apps/website/public/learn/fpga-is-a-grid/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

An FPGA is a grid you configure

You will learn

What an FPGA is made of, and why a design uses only part of the chip.

A CPU runs instructions one after another. An FPGA has no program at all: it is a grid of small blocks -- lookup tables (LUTs), flip-flops, carry chains, block RAM and DSP multipliers -- joined by wires you can switch. Configuring the grid builds a circuit. Our bench chip is an AMD Artix-7 XC7A200T. The skyline draws one routed design on that die: every tile it configures stands up as a column, and most of the chip stays dark.

Try it

Rotate the die and tap the tallest column: which kind of tile sets the most features? In the spec frame of our bench board, find LUT_TOTAL, then the invariant on DSP48E1_TOTAL: what does its name say our cores use?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

FASM skyline: a routed 7-series design as a city on the XC7A200T die
FASM skyline: a routed 7-series design as a city on the XC7A200T die ↗

Drop a .fasm: every tile it configures becomes a column as tall as the features it sets, on the full XC7A200T grid. Counted in your browser; PNG to share.

specs/boards/wukong_v1.t27

// SPDX-License-Identifier: Apache-2.0
@@ -365,6 +397,7 @@ 

An FPGA is a grid you configure

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/frames-and-the-fcs/index.html b/apps/website/public/learn/frames-and-the-fcs/index.html index 9078fa9987..5d2ecaf29e 100644 --- a/apps/website/public/learn/frames-and-the-fcs/index.html +++ b/apps/website/public/learn/frames-and-the-fcs/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Frames and the FCS

You will learn

How an Ethernet frame ends in a CRC-32, and what the check computes.

An Ethernet frame ends in a frame check sequence: a CRC-32 over the bytes, computed by the sender and recomputed by the receiver. The spec of this lesson, written for this course, carries the polynomial and the arithmetic, and its header labels what the check does and does not claim. The recording runs t27c on it.

Try it

In the recording, watch the run; then in the spec frame find the polynomial the CRC-32 uses and what the header labels as an assumption.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on eth_crc.t27 -- the FCS, native
t27c on eth_crc.t27 -- the FCS, native ↗

t27c test-report on the Ethernet frame check sequence: 8 tests pass natively -- the table derived from one bit step, the check value 0xCBF43926, and the receiver residue 0xDEBB20E3.

specs/fpga/eth_crc.t27

// SPDX-License-Identifier: Apache-2.0
@@ -297,6 +329,7 @@ 

Frames and the FCS

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/framing-a-conversation/index.html b/apps/website/public/learn/framing-a-conversation/index.html index 3e0b26170c..c48ee80d7b 100644 --- a/apps/website/public/learn/framing-a-conversation/index.html +++ b/apps/website/public/learn/framing-a-conversation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Framing a conversation

You will learn

What a clocked conversation changes, and how the SPI spec states its modes and rates.

A conversation needs rules about when a word starts and ends, or the far side samples noise. The clocked answer is SPI, and the spec of this lesson, SPI_Master, states its ground: CLK_FREQ at 50,000,000, SPI_CPOL and SPI_CPHA at 0, a maximum data width of 32 bits. The recording runs t27c check on it: 0 errors, 0 warnings. The three buses this module opens -- UART, SPI, APB -- are the three answers the course takes apart, one per module.

Try it

In the recording, find the error and warning counts; then in the spec frame find CLK_FREQ, CPOL and CPHA, and say which mode the spec configures.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c check on spi.t27 -- the spec compiles
t27c check on spi.t27 -- the spec compiles ↗

t27c check typechecks the SPI spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/spi.t27

// SPDX-License-Identifier: Apache-2.0
@@ -474,6 +506,7 @@ 

Framing a conversation

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/fsm-coverage/index.html b/apps/website/public/learn/fsm-coverage/index.html index b32f8ebe3e..8c9973263a 100644 --- a/apps/website/public/learn/fsm-coverage/index.html +++ b/apps/website/public/learn/fsm-coverage/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

FSM coverage

You will learn

How state and transition coverage see the arcs a run never took.

A state machine is verified by its arcs, not its states: 4 states with 12 transitions is 12 ways to be wrong, and visiting every state can leave half the arcs cold. The spec models it directly: state points and transition points, each with a hit count, and illegal transitions that fail the report the moment one warms. The widget is the discipline in another shape: 112 files pinned by sha256 in specs, every one accounted for -- 0 lost, 0 not kept, 0 unlocated. Nothing on the list is allowed to be unvisited.

Try it

List the arcs of a 4-state FIFO FSM and mark which a read-only workload leaves cold; then find the illegal arcs in the spec and what warms them.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-tmpcheck · every /tmp file a spec pins, kept
tri fpga-tmpcheck · every /tmp file a spec pins, kept ↗

112 files under /tmp are pinned by sha256 in specs. /tmp is emptied at boot and all 112 are gone from it; every one has a kept copy. 0 lost, 0 not kept, 0 unlocated.

specs/fpga/coverage.t27

// SPDX-License-Identifier: Apache-2.0
@@ -574,6 +606,7 @@ 

FSM coverage

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/full-adder/index.html b/apps/website/public/learn/full-adder/index.html index d42481a9b4..7708bcc2e6 100644 --- a/apps/website/public/learn/full-adder/index.html +++ b/apps/website/public/learn/full-adder/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The full adder

You will learn

Why three trits still fit one sum trit and one carry trit.

A full adder adds a carry from the place below. Three trits sum to -3..3, and that range is always 3 x carry + sum with both still single trits; the spec's test checks all 27 cases. The lesson spec in the player is a different machine: ternary_full_adder.t27 builds a binary full adder out of ternary neurons, the way the repository's FPGA BitNet work does. Same word, two meanings, both runnable.

Try it

Set all three inputs to +1 and then to -1; read the carry and the sum, and find a case whose carry is 0 though no input is 0.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The full adder: a carry comes in, a carry goes out
The full adder: a carry comes in, a carry goes out ↗

Add a carry from the place below. Three trits sum to -3..3, still one sum trit and one carry trit: 27 cases, every one shown.

specs/ternary/ternary_full_adder.t27

module TernaryFullAdder;
@@ -146,6 +178,7 @@ 

The full adder

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/functions/index.html b/apps/website/public/learn/functions/index.html index f1ec96f74f..7b8c843d07 100644 --- a/apps/website/public/learn/functions/index.html +++ b/apps/website/public/learn/functions/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Functions

You will learn

The two ways t27 writes a function signature, and the body with return.

fn add(a: u8, b: u8) -> u8 declares a function with two u8 inputs and a u8 result; the body in braces ends with return. The compiler also accepts the Zig style, pub fn add(a: u8, b: u8) u8, without the arrow. There are no generics: fn id<T> is a parse error. The test runner on this site checks constants and does not call functions, so the lesson keeps the expected results as constants beside them.

Try it

Write a function sub in the player in either style and check the verdict stays clean.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 12: a function signature, piece by piece
t27 basics 12: a function signature, piece by piece ↗

The pieces of a t27 function signature in both styles the compiler accepts, and the generics it does not. Lesson 12 of the t27 basics course.

specs/basics/12_functions.t27

// SPDX-License-Identifier: Apache-2.0
@@ -87,6 +119,7 @@ 

Functions

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gated-clock-trap/index.html b/apps/website/public/learn/gated-clock-trap/index.html index 76022f224b..9db1869c5c 100644 --- a/apps/website/public/learn/gated-clock-trap/index.html +++ b/apps/website/public/learn/gated-clock-trap/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The gated-clock trap

You will learn

Why gating a clock with logic makes a new domain, and what a clock enable is for.

Gating a clock with logic -- an AND gate on the clock line to save power -- cuts the clock with a signal that changes at data speed, makes glitches, and quietly creates a new clock domain of everything downstream. The rule: never gate a clock; use a clock enable, which the flop samples at the edge instead of the edge sampling it. The widget shows the discipline of proving such claims: two bitstreams that differ in three bits, and a knockout build per bit, each clearing one, so no bit can claim credit it does not earn. The spec frame opens clock_domain.t27, whose gated_clk source kind is the model of this trap.

Try it

In the widget, find how many bits the A/B bitstreams differ by and how each was cleared; then in the spec frame find the gated-clock source kind and the strategy enum value a gated clock forces.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Race the bee: who lands patches on t27, a person or a bee
Race the bee: who lands patches on t27, a person or a bee ↗

A dated snapshot of gHashTag/t27: merged pull requests by the Queen's bees and by people, the issues both lanes went for, and the open ones nobody has taken.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

The gated-clock trap

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gelu/index.html b/apps/website/public/learn/gelu/index.html index b4c092d4f6..eab8379c1e 100644 --- a/apps/website/public/learn/gelu/index.html +++ b/apps/website/public/learn/gelu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GELU: a dip below zero

You will learn

What GELU computes, why it dips below zero, and how close its tanh shortcut comes.

GELU weighs x by the chance that a standard normal draw is below it: GELU(x) = x Phi(x). A large positive input passes, a large negative one vanishes, and in between the curve dips to about -0.17 near x = -0.75 before it rises. BERT and GPT use it in their feed-forward layers. The exact form needs erf, which the spec computes with the Abramowitz-Stegun fit, good to 1.5e-7, and it also computes the tanh shortcut: at -0.75 they give -0.16997 and -0.17004. The spec gelu_activation.t27 computes both curves and their slopes.

Try it

Find the lowest point of the curve by its slope; then compare the exact and the tanh form at -3.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GELU: why transformers bend a little below zero
GELU: why transformers bend a little below zero ↗

Drag along GELU: x weighed by the chance a normal draw is below it. It dips to about -0.17 before it rises, and the tanh shortcut stays within a few thousandths of the exact form.

specs/ml/activation/gelu_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -235,6 +267,7 @@ 

GELU: a dip below zero

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gen-ts/index.html b/apps/website/public/learn/gen-ts/index.html index 5ef8f49879..f09a086c2c 100644 --- a/apps/website/public/learn/gen-ts/index.html +++ b/apps/website/public/learn/gen-ts/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

gen-ts: a spec becomes TypeScript

You will learn

What gen-ts writes for constants and functions, and how a host program uses it.

t27c gen-ts turns each constant into an export const line that TypeScript type-checks. Functions are not emitted: the backend says it lowers declarations, not bodies. This is how this site uses specs: a generator reads a .t27 file and writes the numbers and words a page imports. The table under this lesson shows what gen-ts wrote for the lesson spec.

Try it

Add a constant to the lesson spec in the player and find its line in the ts tab.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 21: what gen-ts writes
t27 basics 21: what gen-ts writes ↗

The TypeScript the real t27 compiler wrote for the lesson spec, line by line next to its source. Lesson 21 of the t27 basics course.

specs/basics/21_gen_ts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -84,6 +116,7 @@ 

gen-ts: a spec becomes TypeScript

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf10-ten-bits/index.html b/apps/website/public/learn/gf10-ten-bits/index.html index 06da57a705..84950777f8 100644 --- a/apps/website/public/learn/gf10-ten-bits/index.html +++ b/apps/website/public/learn/gf10-ten-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF10: ten bits

You will learn

How 10 bits split into 1 + 3 + 6, and why its ratio sits 0.118 from 1 / phi.

GF10 has 10 bits: 1 sign, 3 exponent, 6 mantissa, bias 3. The rule gives E = round(9 / phi^2) = 3, and E / M is 0.5, the same distance of 0.118 from 1 / phi as GF4. Rounding to whole bits is what costs it: at small widths there are few splits to choose from.

Try it

Find EM_RATIO and PHI_DIST in gf10.t27. Then compute round(9 / phi^2) yourself and check it against EXP_BITS.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 10: GF10, ten bits
GoldenFloat 10: GF10, ten bits ↗

GF10: 10 bits as the spec lays them out, read from gf10.t27. Lesson 10 of the GoldenFloat course.

specs/numeric/gf10.t27

// SPDX-License-Identifier: Apache-2.0
@@ -152,6 +184,7 @@ 

GF10: ten bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf1024-one-kilobit/index.html b/apps/website/public/learn/gf1024-one-kilobit/index.html index d4dcb581d1..9da90fdb17 100644 --- a/apps/website/public/learn/gf1024-one-kilobit/index.html +++ b/apps/website/public/learn/gf1024-one-kilobit/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF1024: one kilobit

You will learn

The widest rung of the family, 1 + 391 + 632, and the test that names it.

GF1024 has 1024 bits: 1 sign, 391 exponent, 632 mantissa. Its ratio E / M is 0.6187, a distance of 0.0006 from 1 / phi, and the family spec has a test that names GF1024 as the format with the smallest phi distance. It is a rung of the family on paper; no hardware in this course computes in it.

Try it

Find PHI_DIST in gf1024.t27. Then in goldenfloat_family.t27 find the test about GF1024 and the function it calls.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 23: GF1024, one kilobit
GoldenFloat 23: GF1024, one kilobit ↗

GF1024: 1024 bits as the spec lays them out, read from gf1024.t27. Lesson 23 of the GoldenFloat course.

specs/numeric/gf1024.t27

// SPDX-License-Identifier: Apache-2.0
@@ -150,6 +182,7 @@ 

GF1024: one kilobit

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf12-twelve-bits/index.html b/apps/website/public/learn/gf12-twelve-bits/index.html index d96fa82b8b..c268e8e42e 100644 --- a/apps/website/public/learn/gf12-twelve-bits/index.html +++ b/apps/website/public/learn/gf12-twelve-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF12: twelve bits

You will learn

The twelve-bit GoldenFloat, 1 + 4 + 7, bias 7, and how a test name can promise more than its assert.

gf12.t27 holds 12 bits: 1 sign, 4 exponent, 7 mantissa bits, and bias 7. Its ratio E / M is 4 / 7 = 0.571, and PHI_DISTANCE is 0.0466. The test that checks it is named gf12_phi_distance_lowest, but it asserts only that the distance is under 0.05, and a comment in the spec calls GF12 the closest of all formats. The family says otherwise: GF14 in the next lesson sits 0.007 from 1 / phi, and GF32 0.0135. Read a test by its assert, not by its name. MEMORY_RATIO_VS_FP32 is 12 / 32 = 0.375.

Try it

Find PHI_DISTANCE and the test gf12_phi_distance_lowest in gf12.t27. Then compare the distance with GF14 and GF32 and say what the test name claims that its assert does not.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 11: GF12, twelve bits
GoldenFloat 11: GF12, twelve bits ↗

GF12: 12 bits as the spec lays them out, read from gf12.t27. Lesson 11 of the GoldenFloat course.

specs/numeric/gf12.t27

// SPDX-License-Identifier: Apache-2.0
@@ -560,6 +592,7 @@ 

GF12: twelve bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf128-a-quad/index.html b/apps/website/public/learn/gf128-a-quad/index.html index e8d9703069..5fe3075f86 100644 --- a/apps/website/public/learn/gf128-a-quad/index.html +++ b/apps/website/public/learn/gf128-a-quad/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF128: a quad

You will learn

The 128-bit GoldenFloat, 1 + 49 + 78, and the four invariants that hold its layout.

GF128 has 128 bits: 1 sign, 49 exponent, 78 mantissa. IEEE quad spends 15 bits on the exponent. The spec holds the layout with four invariants: the fields partition the word, the mantissa and the exponent follow the closed form, and the shifts follow the layout.

Try it

Read the four invariants of gf128.t27 and check SIGN_SHIFT and EXP_SHIFT against the field widths by hand.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 20: GF128, a quad
GoldenFloat 20: GF128, a quad ↗

GF128: 128 bits as the spec lays them out, read from gf128.t27. Lesson 20 of the GoldenFloat course.

specs/numeric/gf128.t27

// SPDX-License-Identifier: Apache-2.0
@@ -144,6 +176,7 @@ 

GF128: a quad

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf14-fourteen-bits/index.html b/apps/website/public/learn/gf14-fourteen-bits/index.html index fb01f03498..54444e7264 100644 --- a/apps/website/public/learn/gf14-fourteen-bits/index.html +++ b/apps/website/public/learn/gf14-fourteen-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF14: fourteen bits

You will learn

How 14 bits split into 1 + 5 + 8, a ratio 0.007 from 1 / phi.

GF14 has 14 bits: 1 sign, 5 exponent, 8 mantissa, bias 15. Its ratio E / M is 0.625, only 0.007 from 1 / phi, because 5 and 8 are neighbouring Fibonacci numbers, and the ratio of neighbours approaches 1 / phi.

Try it

Find PHI_DIST in gf14.t27 and compare it with GF10. Then name the next pair of Fibonacci numbers after 5 and 8.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 12: GF14, fourteen bits
GoldenFloat 12: GF14, fourteen bits ↗

GF14: 14 bits as the spec lays them out, read from gf14.t27. Lesson 12 of the GoldenFloat course.

specs/numeric/gf14.t27

// SPDX-License-Identifier: Apache-2.0
@@ -152,6 +184,7 @@ 

GF14: fourteen bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf16-the-primary/index.html b/apps/website/public/learn/gf16-the-primary/index.html index 170edeae49..a5d90c28aa 100644 --- a/apps/website/public/learn/gf16-the-primary/index.html +++ b/apps/website/public/learn/gf16-the-primary/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF16: the primary format

You will learn

The 16-bit GoldenFloat the family marks primary: 1 + 6 + 9, bias 31, and its special codes.

GF16 has 16 bits: 1 sign, 6 exponent, 9 mantissa, bias 31. Exponent code 63, all ones, is kept for infinity and NaN, as in IEEE 754. The spec gives every special code a name: 0x0000 and 0x8000 for the two zeros, 0x7E00 and 0xFE00 for the two infinities, 0xFE01 for NaN. A mantissa of 9 bits divides by 512.

Try it

Find SIGN_MASK, EXP_MASK and MANT_MASK in gf16.t27 and check that together they cover all 16 bits. Then find the code of NaN and say which field makes it not an infinity.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 13: GF16, the primary format
GoldenFloat 13: GF16, the primary format ↗

GF16 special codes, read from gf16.t27. Lesson 13 of the GoldenFloat course.

specs/numeric/gf16.t27

// SPDX-License-Identifier: Apache-2.0
@@ -3861,6 +3893,7 @@ 

GF16: the primary format

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf24-twenty-four-bits/index.html b/apps/website/public/learn/gf24-twenty-four-bits/index.html index adba708c34..749a294458 100644 --- a/apps/website/public/learn/gf24-twenty-four-bits/index.html +++ b/apps/website/public/learn/gf24-twenty-four-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF20 and GF24

You will learn

The 20- and 24-bit GoldenFloats, 1 + 7 + 12 and 1 + 9 + 14, and the tolerance each spec allows.

gf20.t27 holds 1 sign, 7 exponent and 12 mantissa bits with bias 63; gf24.t27 holds 1 sign, 9 exponent and 14 mantissa bits with bias 255. The lesson opens gf24.t27, whose PHI_DISTANCE is 0.0248, and its test allows anything under 0.03; MEMORY_RATIO_VS_FP32 is 0.75. GF20 writes its distance as 0.03463, under a test bound of 0.04, while 7 / 12 sits 0.03470 from 1 / phi: the stored constant and the arithmetic differ in the fourth decimal. Between them, both widths keep the ratio within 0.035 of 1 / phi.

Try it

Find PHI_DISTANCE and EXP_BIAS in gf24.t27 and check the bias against 2^(9 - 1) - 1. Then compute 7 / 12 against 0.618034 and compare it with the constant gf20.t27 stores.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 15: GF20 and GF24
GoldenFloat 15: GF20 and GF24 ↗

GF24: 24 bits as the spec lays them out, beside GF20, read from gf24.t27. Lesson 15 of the GoldenFloat course.

specs/numeric/gf24.t27

// SPDX-License-Identifier: Apache-2.0
@@ -547,6 +579,7 @@ 

GF20 and GF24

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf256-two-five-six/index.html b/apps/website/public/learn/gf256-two-five-six/index.html index a4d2afd997..829c4b0848 100644 --- a/apps/website/public/learn/gf256-two-five-six/index.html +++ b/apps/website/public/learn/gf256-two-five-six/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF256: two hundred fifty-six bits

You will learn

How the rule splits 256 bits into 1 + 97 + 158.

GF256 has 256 bits: 1 sign, 97 exponent, 158 mantissa. The family spec has a test for these counts too. At this width rounding costs little, and the ratio E / M is 0.614, 0.004 from 1 / phi.

Try it

Find EM_RATIO and PHI_DIST in gf256.t27. Then in goldenfloat_family.t27 find the test that checks the GF256 bit counts, and check that both specs agree.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 21: GF256
GoldenFloat 21: GF256 ↗

GF256: 256 bits as the spec lays them out, read from gf256.t27. Lesson 21 of the GoldenFloat course.

specs/numeric/gf256.t27

// SPDX-License-Identifier: Apache-2.0
@@ -144,6 +176,7 @@ 

GF256: two hundred fifty-six bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf32-a-single/index.html b/apps/website/public/learn/gf32-a-single/index.html index 2f44814e63..db85223bf4 100644 --- a/apps/website/public/learn/gf32-a-single/index.html +++ b/apps/website/public/learn/gf32-a-single/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF32: a single

You will learn

The 32-bit GoldenFloat, 1 + 12 + 19, bias 2047, and the two invariants that compare it with IEEE single.

gf32.t27 holds 32 bits: 1 sign, 12 exponent, 19 mantissa bits, and bias 2047. IEEE single spends 8 bits on the exponent and 23 on the mantissa; the spec keeps two invariants that say so, EXP_BITS > 8 and MANT_BITS < 23, so GF32 trades precision for range at the same width. Its PHI_DISTANCE is 0.0135, under the test bound of 0.015, and MEMORY_RATIO_VS_FP32 is 1. A comment calls GF32 second after GF12; by the distances in this course it is closer than GF12, and GF14 is closer still.

Try it

Find the two invariants of gf32.t27 that compare it with IEEE single. Then check EXP_BIAS against 2^(12 - 1) - 1 and compute 12 / 19.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 16: GF32, a single
GoldenFloat 16: GF32, a single ↗

GF32: 32 bits as the spec lays them out, beside IEEE single, read from gf32.t27. Lesson 16 of the GoldenFloat course.

specs/numeric/gf32.t27

// SPDX-License-Identifier: Apache-2.0
@@ -558,6 +590,7 @@ 

GF32: a single

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf4-four-bits/index.html b/apps/website/public/learn/gf4-four-bits/index.html index a7fb7fdbdd..1660f485d2 100644 --- a/apps/website/public/learn/gf4-four-bits/index.html +++ b/apps/website/public/learn/gf4-four-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF4: four bits

You will learn

The smallest GoldenFloat: one sign bit, one exponent bit, two mantissa bits, bias 0.

GF4 has 4 bits: 1 sign, 1 exponent, 2 mantissa, and its exponent bias is 0. With one exponent bit there are only two scales, 1 and 2, so its 16 codes are coarse. The rule gives E = round(3 / phi^2) = 1, and the ratio E / M is 0.5, a distance of 0.118 from 1 / phi. The AI numbers course opens the same spec for another reason; here it is the lowest rung of the family.

Try it

Find EXP_BIAS and PHI_DISTANCE in gf4.t27, then the invariant that bounds the distance. Open the decode function and find the two scales one exponent bit gives.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 7: GF4, four bits
GoldenFloat 7: GF4, four bits ↗

GF4: 4 bits as the spec lays them out, read from gf4.t27. Lesson 7 of the GoldenFloat course.

specs/numeric/gf4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -373,6 +405,7 @@ 

GF4: four bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf48-forty-eight-bits/index.html b/apps/website/public/learn/gf48-forty-eight-bits/index.html index 4dc406987c..d1505ee5f1 100644 --- a/apps/website/public/learn/gf48-forty-eight-bits/index.html +++ b/apps/website/public/learn/gf48-forty-eight-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF48: forty-eight bits

You will learn

How the rule splits 48 bits into 1 + 18 + 29, a width IEEE 754 does not have.

GF48 has 48 bits: 1 sign, 18 exponent, 29 mantissa, bias 131071. IEEE 754 has no 48-bit format; the rule makes one the same way it makes all the others. Its ratio E / M is 0.621, 0.003 from 1 / phi.

Try it

Find BIAS and EXP_MAX in gf48.t27 and check them against 2^17 - 1 and 2^18 - 1. Then find the three shift constants and say which field each one places.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 17: GF48, forty-eight bits
GoldenFloat 17: GF48, forty-eight bits ↗

GF48: 48 bits as the spec lays them out, read from gf48.t27. Lesson 17 of the GoldenFloat course.

specs/numeric/gf48.t27

// SPDX-License-Identifier: Apache-2.0
@@ -152,6 +184,7 @@ 

GF48: forty-eight bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf512-five-twelve/index.html b/apps/website/public/learn/gf512-five-twelve/index.html index d110842e16..84087362c6 100644 --- a/apps/website/public/learn/gf512-five-twelve/index.html +++ b/apps/website/public/learn/gf512-five-twelve/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF512: five hundred twelve bits

You will learn

How the rule splits 512 bits into 1 + 195 + 316, a ratio within 0.001 of 1 / phi.

GF512 has 512 bits: 1 sign, 195 exponent, 316 mantissa. Its ratio E / M is 0.617, under 0.001 from 1 / phi. The wider the word, the closer whole bits can come to the target, which is the trend the family table shows.

Try it

Find PHI_DIST in gf512.t27 and compare it with GF14 and GF48. Then check SIGN_SHIFT and EXP_SHIFT by hand.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 22: GF512
GoldenFloat 22: GF512 ↗

GF512: 512 bits as the spec lays them out, read from gf512.t27. Lesson 22 of the GoldenFloat course.

specs/numeric/gf512.t27

// SPDX-License-Identifier: Apache-2.0
@@ -145,6 +177,7 @@ 

GF512: five hundred twelve bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf6-six-bits/index.html b/apps/website/public/learn/gf6-six-bits/index.html index 2b02ff66c9..74905cb55f 100644 --- a/apps/website/public/learn/gf6-six-bits/index.html +++ b/apps/website/public/learn/gf6-six-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF6: six bits

You will learn

How the rule splits 6 bits into 1 + 2 + 3, and what bias 1 means.

GF6 has 6 bits: 1 sign, 2 exponent, 3 mantissa. Two exponent bits give codes 0 to 3, and with bias 1 the scale runs from 2^-1 to 2^2. The ratio E / M is 0.667, a distance of 0.049 from 1 / phi. The spec keeps a status line too: the bias is not derived from the closed form, it is chosen per format, and the spec says so.

Try it

Find BIAS and EXP_MAX in gf6.t27 and check them against 2^(E-1) - 1 and 2^E - 1. Then read PHI_BIAS_STATUS and say what it admits.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 8: GF6, six bits
GoldenFloat 8: GF6, six bits ↗

GF6: 6 bits as the spec lays them out, read from gf6.t27. Lesson 8 of the GoldenFloat course.

specs/numeric/gf6.t27

// SPDX-License-Identifier: Apache-2.0
@@ -152,6 +184,7 @@ 

GF6: six bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf64-a-double/index.html b/apps/website/public/learn/gf64-a-double/index.html index 8a7d7a1171..4d9119db11 100644 --- a/apps/website/public/learn/gf64-a-double/index.html +++ b/apps/website/public/learn/gf64-a-double/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF64: a double

You will learn

The 64-bit GoldenFloat, 1 + 24 + 39, beside IEEE double, and how its encoder clamps the exponent.

GF64 has 64 bits: 1 sign, 24 exponent, 39 mantissa, bias 8388607. IEEE double spends 11 bits on the exponent and 52 on the mantissa; GF64 trades mantissa for a far wider range. Its spec has an encoder and a decoder: the mantissa divides by 2^39, and the exponent is clamped between 0 and 2^24 - 1.

Try it

Find EXP_BIAS, EXP_MAX and MANT_DIV in gf64.t27. Then open encode and find where the exponent is clamped.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 18: GF64, a double
GoldenFloat 18: GF64, a double ↗

GF64: 64 bits as the spec lays them out, read from gf64.t27. Lesson 18 of the GoldenFloat course.

specs/numeric/gf64.t27

// SPDX-License-Identifier: Apache-2.0
@@ -296,6 +328,7 @@ 

GF64: a double

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf8-one-byte/index.html b/apps/website/public/learn/gf8-one-byte/index.html index 7a8e872fe4..6ad87520bf 100644 --- a/apps/website/public/learn/gf8-one-byte/index.html +++ b/apps/website/public/learn/gf8-one-byte/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF8: one byte

You will learn

The one-byte GoldenFloat, 1 + 3 + 4, bias 3, and what its largest and smallest values are.

gf8.t27 holds one byte: 1 sign, 3 exponent, 4 mantissa bits, and bias 3, which is 2^(3 - 1) - 1. PHI_DISTANCE is 0.132, the furthest of the seven widths phi_ratio.t27 lists, since 3 / 4 = 0.75 overshoots 1 / phi. Its largest value, by max_value, is (1 + 15/16) * 2^(7 - 3) = 31, and its smallest, by min_positive, is 1/16 * 2^-2 = 1/64. The comments above both functions say 15.5 and 0.0625; the code computes 31 and 1/64. MEMORY_RATIO_VS_FP32 is 0.25: four GF8 values fit where one FP32 does.

Try it

Compute max_value and min_positive of gf8.t27 by hand and compare them with the comments above them. Then decode the code 0b01000000 that the test gf8_phi_distance expects for phi, and say what value it holds.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 9: GF8, one byte
GoldenFloat 9: GF8, one byte ↗

GF8: 8 bits as the spec lays them out, read from gf8.t27. Lesson 9 of the GoldenFloat course.

specs/numeric/gf8.t27

// SPDX-License-Identifier: Apache-2.0
@@ -596,6 +628,7 @@ 

GF8: one byte

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gf96-ninety-six-bits/index.html b/apps/website/public/learn/gf96-ninety-six-bits/index.html index ce8b9ef532..513f620671 100644 --- a/apps/website/public/learn/gf96-ninety-six-bits/index.html +++ b/apps/website/public/learn/gf96-ninety-six-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF96: ninety-six bits

You will learn

Why the spec of a 96-bit float writes its bias as an expression, not a number.

GF96 has 96 bits: 1 sign, 36 exponent, 59 mantissa. Its bias, 2^35 - 1, no longer fits the 64-bit integer types the spec uses for small formats, so the spec writes it as the text 2^(36-1) - 1 and checks the layout with invariants instead. The ratio E / M is 0.610.

Try it

Find BIAS_EXPR and EXP_MAX_EXPR in gf96.t27 and compare them with BIAS in gf48.t27. Then read the invariants and say what each one checks.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 19: GF96, ninety-six bits
GoldenFloat 19: GF96, ninety-six bits ↗

GF96: 96 bits as the spec lays them out, read from gf96.t27. Lesson 19 of the GoldenFloat course.

specs/numeric/gf96.t27

// SPDX-License-Identifier: Apache-2.0
@@ -144,6 +176,7 @@ 

GF96: ninety-six bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gft16-six-trits/index.html b/apps/website/public/learn/gft16-six-trits/index.html index 19eba3ffe5..8dc1d73f91 100644 --- a/apps/website/public/learn/gft16-six-trits/index.html +++ b/apps/website/public/learn/gft16-six-trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF-T16: six trits

You will learn

How GF-T16 spends 6 exponent trits and 9 mantissa bits, and how many exponent values that gives.

GF-T16 has 1 sign, 6 exponent trits and 9 mantissa bits. Six trits give 3^6 = 729 exponent values; offset 364 balances them and offset 728 is not finite. The split in thousandths is 6000 / 9 = 666. Its mantissa has the same 9 bits as GF16, so the two differ only in how they store the exponent.

Try it

Run the two tests of gft16.t27. Then compare MANT_BITS with GF16 and work out the range 729 exponent values cover around zero.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 25: GF-T16, six trits
GoldenFloat 25: GF-T16, six trits ↗

GF-T16 as the spec lays it out, read from gft16.t27. Lesson 25 of the GoldenFloat course.

specs/numeric/gft16.t27

// SPDX-License-Identifier: Apache-2.0
@@ -123,6 +155,7 @@ 

GF-T16: six trits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gft32-twelve-trits/index.html b/apps/website/public/learn/gft32-twelve-trits/index.html index b848a1d30f..68b98abf05 100644 --- a/apps/website/public/learn/gft32-twelve-trits/index.html +++ b/apps/website/public/learn/gft32-twelve-trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF-T32: twelve trits

You will learn

How GF-T32 spends 12 exponent trits and 19 mantissa bits.

GF-T32 has 1 sign, 12 exponent trits and 19 mantissa bits. Twelve trits give 3^12 = 531441 exponent values; offset 265720 balances them and offset 531440 is not finite. The split in thousandths is 12000 / 19 = 631. The 19 mantissa bits match GF32 in the family table.

Try it

Run the two tests of gft32.t27 and check 3^12 by hand. Then compare its mantissa with the GF32 row of the family spec.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 26: GF-T32, twelve trits
GoldenFloat 26: GF-T32, twelve trits ↗

GF-T32 as the spec lays it out, read from gft32.t27. Lesson 26 of the GoldenFloat course.

specs/numeric/gft32.t27

// SPDX-License-Identifier: Apache-2.0
@@ -123,6 +155,7 @@ 

GF-T32: twelve trits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gft8-exponent-in-trits/index.html b/apps/website/public/learn/gft8-exponent-in-trits/index.html index 6424258010..c223977038 100644 --- a/apps/website/public/learn/gft8-exponent-in-trits/index.html +++ b/apps/website/public/learn/gft8-exponent-in-trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

GF-T8: an exponent in trits

You will learn

How GF-T keeps the phi split but stores the exponent in balanced trits: 1 + 3 trits + 4 bits.

GF-T is GoldenFloat with a ternary exponent. GF-T8 has 1 sign, 3 exponent trits and 4 mantissa bits. Three trits give 27 exponent values, offset 13 makes them balanced around zero, and offset 26 is kept as the one non-finite value. The spec tests the split as E / M in thousandths: 3000 / 4 = 750.

Try it

Run the two tests of gft8.t27. Then find exp_values and is_finite and say which offset is not finite.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 24: GF-T8, an exponent in trits
GoldenFloat 24: GF-T8, an exponent in trits ↗

GF-T8 as the spec lays it out, read from gft8.t27. Lesson 24 of the GoldenFloat course.

specs/numeric/gft8.t27

// SPDX-License-Identifier: Apache-2.0
@@ -123,6 +155,7 @@ 

GF-T8: an exponent in trits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/global-buffers/index.html b/apps/website/public/learn/global-buffers/index.html index 9e9c13a5eb..d982ba6d72 100644 --- a/apps/website/public/learn/global-buffers/index.html +++ b/apps/website/public/learn/global-buffers/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The global buffer

You will learn

What a global buffer is, why it sits on its own network, and what one real build of the whole flow looked like.

A global buffer, BUFG on a 7-series chip, drives the clock on a dedicated low-skew network so the tree of the last lesson has a clean root. The widget shows the flow a BUFG sits inside: one real XC7A200T build, 116.9 s with openXC7 and 83.5 s through the t27 L3+L4 path, byte-identical bitstreams, and place and route taking 60 percent of it. The buffer is one layer of that picture, and the spec frame opens cts.t27 again, where bufg() is built and bufg_has_higher_fanout() is tested.

Try it

In the widget, find the two build times and what percentage place and route took; then in the spec frame find bufg() and the test that gives it the higher fanout.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri game-selftest: the queen loop checks its own tools
tri game-selftest: the queen loop checks its own tools ↗

6 of 6 self-tests hold: anomalies, blog_drift, lessons, site_gate, tick, vault.

specs/fpga/cts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -292,6 +324,7 @@ 

The global buffer

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/golden-model/index.html b/apps/website/public/learn/golden-model/index.html index b3909f4590..65cb1469ba 100644 --- a/apps/website/public/learn/golden-model/index.html +++ b/apps/website/public/learn/golden-model/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The golden model

You will learn

What a reference model is, and how a conformance suite holds a tool to it.

To judge an implementation you need an answer that did not come from it: a golden model. For a number format that is the paper's table; for a tool it is the reference it claims to match. The widget is the conformance sweep that holds t27's own FPGA toolchain to its reference: 17 of 17 conformance specs compile, their test blocks pass, and no generated file has drifted from what was committed. The lesson's spec is the frame all those testbenches share -- the shapes a tb must have before it can check anything.

Try it

Open tri-fpga-specs and read one conformance spec's test blocks; then open testbench.t27 and name the four shapes a tb must have.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-specs: every board spec, compiled and tested
tri fpga-specs: every board spec, compiled and tested ↗

17 of 17 conformance specs compile, their test blocks pass, and no generated file has drifted.

specs/fpga/testbench.t27

// SPDX-License-Identifier: Apache-2.0
@@ -358,6 +390,7 @@ 

The golden model

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/golden-ruler-vectors/index.html b/apps/website/public/learn/golden-ruler-vectors/index.html index aeb84dc0ba..3da7b2b55b 100644 --- a/apps/website/public/learn/golden-ruler-vectors/index.html +++ b/apps/website/public/learn/golden-ruler-vectors/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Golden ruler vectors

You will learn

How a catalog works as a ruler: every population recounted, every count agreeing.

A ruler only works if it does not stretch. The formats catalog is t27's ruler for number formats, and the widget is the check on the ruler itself: four census populations -- counted in the catalog, recounted another way -- all agree, and the three that cannot be checked are named as uncheckable rather than rounded into agreement. That is the pattern to copy: recount every count a second way, and publish the ones you cannot.

Try it

Open the census widget and name the three populations marked uncheckable; then read the formats catalog and find one count stated twice.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri census audit: every census, counted twice
tri census audit: every census, counted twice ↗

Four census populations recounted another way all agree; three are named as uncheckable.

specs/numeric/formats_catalog.t27

// SPDX-License-Identifier: Apache-2.0
@@ -563,6 +595,7 @@ 

Golden ruler vectors

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/goldenfloat/all/card.png b/apps/website/public/learn/goldenfloat/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..6f8ccdb47d9b5ffb205a0ef49b674ab91da5a613 GIT binary patch literal 37092 zcmeEtWmHtr-!2x25{in1fGFY6jkI)w4Bbi(Dczxf8 z5C3<)AMTfXzrAbSwJvMHSpy7bv-fX5zbEzyd#@%>{DA5K9v&XCqJj(<5ASXb9^P$_ z`?rDb{Cc(X5D)JWo}!GTmRH8k0;!QU_VQ$3^NGxlcg#i2Oe*xxRQ2i@9rKFVjZ6^` z)(W;Ufl|xVON~I*dbiT@fud(seAgBq`+1BcHI-_+9z4tl4;=Y5Inf1@d-=r>j)Ok0 zPWBxZntzxKU&s0#U6Kq7;ZTR`uHx&5SAM`3NHH)7JUo@s%$w2RaWUSO`p*^g|F8c~ z%tNUT-J`3$PSTs|!s82#;Al~R4BF7&y?Gh`>gE6WYP%r4bn}aNTT$fyv&()n>?TsU zkc0eeien4))5;gT8$+IO_fxIi?V`a90ju}+_SufN3T3^$MR+uyv*{%V&R%ZsD)bu) zF=?&$#}qR5Mw{X)kss)#O=oKv3uDf#QC}oGt^9oq>{x?gLQO6z6>}e(-qLe>4y5ur z>)G4e%h;^e`g?mD>TsmgyKFaG^EW##o_~Y57BQ06IT<&oH<^esV}s3_E2Y1QH=Fl2 zi1)R3cjAlHG_H*s`*fCz2&hDs3>b3Rk5s4+PoAMbsUqM|q3oW%ytV=2i01?Ph5k#c zyvZhF&O-xXo%p37IgnUVv-xTU#1*wrUAxXNQE|#ITiR*1iz+*$#tV`gts47 zWC#4~nV^`Tu2Bs}cLEi7&T$5*6sZqHFRh*yC*a#oZHAi~i!d}<$J7kbB-AbIZ0Bau zIm|kr_+}1@i6cE0uN{Xvp%*1dMnHt)3^jFax>>%Lzi>)-gt94w zIOW4}>$cgwY1{OHG>c7cn?0|a*lpD&Q!ls4IT!Us{3mvb)?)eu*-%~u(RUqwj=|G- z*g^9`mF4H{fxYrR&2e+<(N4<7E&DYcg<71*MrT+jr%?e-y1=SkVM>oElDsF9Jp}E$ z7@GujQRzAj43+C5iN7W@ZzZNa^t;k8q-=Hbi_ zK1JY7&f4Owg)<_h9bTL19C33px|3h*3B+Mg33gX!Gr``;$F*Tko->nBCuF>JUI;MF z&J6lK%{`_QO&OoU!(^Fi2zz(FM@?>BRCpu=-&V3|p6*Je_8>CM5Vcw(SZsnS-@|k0 zhi=vJfavf&HwxC4(ZY8L%CD&(&6i4xtonw16;|LrNN|WhvzsbioJM$dxr<%zl4P>O zM3}Ld1y|#(Z4qSyk6P}W^J+&JYiaXql7|>7l;PF(#AV{R=lpV9kr){MLHU|q5Ep~S z9kV)NK9O48_91FDKXCGK|5@Wbg_6dkOxn$r>GF{HEp`>d%!fxkRcXzH=m!3TZ8BbC zG5c2s+J?~^g&Y#fD!Vl_jPm|%)wjd~+!C?CNN+9BzT>M;E-<1ar9=( z=AT&n-frqaR%Q;TX2R7=PTbd+A;8S8PMJ{mVSk{@@i8J|-F}+e*|?T8 zuLeo{#5`UXA^0_fl!n)}V<|!M0L>b4U_@=hshR=Ri^8`Y28O!uLzjyFA-Q^_cFZsT zsp0Z@Zr72TuctB*cq2P3tm>JuJm&9$WPI^TJ>$gxwk z>y7yi+~Aoj+*IMZ!LU18!ggn4x~k(cKF*A!RiJi!43RP3z5C+W9Rf4fGeW-Mr>YRo zYTZYxw#GEqcSTdBkHcN3P73~=Iy$hcIu}fYqDjC>z{+h~yQY)ik0Uv3n0j?wNEX(VK_v>Q_vuSX^#E3n|;9e=*#pjgYZ`@{EJjsb4f^8}Z zHT3A={3$(UlJqww#uk&3=HoE>VJ0^QrM9SJGy}!ej4JN`qwz5nVX+#v%^aUAk)M?^ zs%Y@Ah7T^DIYte%y)vZYSZHQEyr`=@Z8Z2a>q(s;T9IyGl+DZS{jc@3dl7T}_cS5Q z^=@=~*T?5QHr2*>IC z&L-K}cLcJ3u9F;7g}5zeCNI0Yv#ZjDoM-WcP(jmO+_m(Lg2}vO<@l$vr6ACjHp`Hy zptYHjK`h&rz#oq~zfHION$oMPl_RKeS0#H^ONP0OI>!;GXvZx+e;Wi8L``K(35q$@{*GK#9CO?a| z1u&worj9nUA_d1h%iU=+eKs;vcwN*>9_JQXCQ7m@A6r!Tk9lZ_9DPTZdcT@;-?EI= z@?P7+Try9DOtY$-Q!rqU%M@XDyvHvtQ68}-!_%Aus9aq*ZRXQM9@FH}prF1y|MO_{ zT#aS+>-VDU%1VjTj<<3bjHIIK3%#kqnlWFKFw>qp7i;LwP}K&0Zj9b$x)+xWF{}N@ zop0<53`S^j>bc@eg6yW!CPwUdndf?KTU*{C0aImb#B(k4!-ctx{x&5J+em+r z@S*12ti&c%Uf;_1AiPs1!ry*=K11ZI=r`bR-7E{QS`g|Yrc*(9hV5YQit*ZH>qFfl z268N6CEJ3o4E0OAhEM$da(5Vx?WWWSG2@s4XFJ8#DqER1*IM~9VHDKh>qU-tmt=)! zE3wPb%(APB+X$X+viU0MpzK+$(gqc@#r3#pA&d$ zYwA2~SEo+jy#2fWTsJDlbhU2J??OZ0r()c4V)H_~9#hrmfBwBI%+|UG$qq?9_j^p# z5c9o}KkM1*D!PB$RfX~?{h;~d2#JNordPyKeQEWJj{aAlD|-wD{gYPCA`*L#6+2yJ z-i7d4aGV_ZUC)o5H@CN%-ok6ZPekIqK{IvOzMHPnBq%)Ci(Sq%_no^fg?;vW3m-q^ z_wns9sO!+8OO^Xm4zz5?mhC#MQZx;2Y2JQ(tQuG_;TSj_h#e?hwtYDZO>Ur}6-_O`q>$^TZ-F(`7nV?B{D@L6{J$zAiGqwt#@{q zjKd)$J^F>C>Sv9h)d!7|M+I1gFl`}|1&KDzVcHIKw3aPRuWD_4GYjmSn%IQgWV7NoeH{LQs* z(auk~Zq;{FSz8Z7tP2>SJL8Wb@!A&_iZ!=6xkz)#T-^JRw4>n91!%XaLbe&5y2Dbj`tjDNcpZ;48U@JbZF;P94DY`etXaar>n z4Aq>e0pW7o3Vdt1RbuGRiH&;Ls8B6Y;NQ}JjY%2vO-HF#X;OcU6tAw9rN5Ot{?|J= zufm8<3}tvlM7mqt^mtO}Pn>CWZG9G%p2)<@kg(d4o0t2b_ zxkDrCNJ)gb*=k_ns7V?(=%y;Gx%7I&<_xJqqkWop6|7Ovcz1@ z2sdj4i>@#yXrb=Ino?!`6`G))%$%2bNUQi&G zg?zI|@gR?hwsYFKZ6Y4AXMPEuD|HG;OiXCZturoXzPA@@_xx9Rgka(Bhz|lYKT1=c z%@Iu*fZmh5EKL1VZFl|8^C(8-Xtbp%%D&P6EDi)JjxMKa1owe>*{6QiBSp}vfzrIxQmQPzHqTGh z|C*!4+Vz~sKlh}1iCgHoD zTPWy4su_esEBKd3CY$l4@bvB9_=8gS7t2yZxpMwXyzfk5GOVSqw6cUVvYjtf_F$gf z?wCiYYWd#G;&xqwTl}vY${v4&t91|3xV?S#TdzNB%eHXF%jop+`@@zGpLS^K%`=nE z-O)4rALPR%Z@*21UpO~XHW=eHaN=C^c`51o1c{Kv^XPHnQuCHlClWOkwSAkc!^2KQ z0!9z|F*}ATKx$lngMX^Tbt3eQ!}lKJg)3w(P6CHi<{bPv2{&{{bVLbsEBcNy{w_Y&imdhLNqy5-y>eU zk)=$KrnUaV4g1X(6&bN7OY=}(vb*@6#G1Xi)uQf29rv6K|3QsK*29lID)T270yY}u ze-mxc^4cG5jCPvweG}ftDA*0zS60$U*!xYw7q9mP8lPBB{j@uW3}#MMY2vbUjYjKz zE8Q2T+N{ZQNI>O$nXVJ-q~q0-E^~YY6Fme5kcE0vl5u2fakZS(XiHJF_BWAyxe)mR zZkXq;T7Xjj6vxldp`*_oVpSVu8sEkhVC$LX0?u$}P5c`N*r1S28iwkof zHwm$_Dl4;YK6`-2j)L-T-G36$kyI1pYFRv_So(7(L0Hg#>VpI!xw^JM#T&07f#KYx zDQNFko)WQ>20@9Yzh8=kQPC~Cw>~C4{Hz_sh?!j^qU5o7Kl~v%uD)5`HhXW`Z^dCu z?K0Fs+t~R;$nHwOT>wi03%&01|J(18=@XObH)Ra+jM|zSg+K`Ay5f*benpVt%MwxT zB7Ew&-x<;4W_B>JdYbc7EA3t??Uv&QI7JyR%mAffyltf&)%*mxkal+Ia)q+YPx)8B z|7QK`sC@Z~2s5gT=JH{3LdVBs2>Nac2&F2m@6l$?gLj>q$5|20@jjE~{eJxTs^u2H zgZ7Zyk(N=tbizY~(iK)r|hwD`a2j&lm5k5{P=SSC2L>s|I~ zbaCwsxDil<=0vh|p^%`fd?t;g`nrR{plH#Uf|rl!TGA_bU8br5KWxBEva&C58&?Q~ z*P--dsK3N5Ja(f&t&mLNbM3jSI%3h;+;RhQQP%^NJHC-h^euXs*Dv3C>IcdCnu)bp@_H_ATeEA;O3k)u(^&KmZTY|WIK_tvlmxR0qyx3Fv_+&`^4$E?O? zv5M67mZ_bLifk5Xa4(49yKQlQIvULXJ;CF*pCzn50M+yrAJTk?Gl&XVS9>sFIpGXRvfjvCO8n=uS`N$wru$`O+X6%SBJ}4y0^w;EAq+2 zWTzUW^kC)V+$qWSsxYn#swq!WickdaR_33%@7lB~c+OkUb$h7SrphPrEQ*BKKC<$) zQxCu9ZGMriZ)drglpq<_&)4%zBQ#zy@`uE+gB~h3>JFJzhg=e(Nqfd@>mzQR#m|1Mz0<4KdL}TF)jSAzO64I?-XU!v*pSj=9aY z#D~bZvAEZ_&6tZEQ#bTXQj>*UYYnvmn%=tZ_qBDU*4}!&<(2i^%IVEQ-COsFxsO?c z>gn;q+^z=p8#xJyBH)ZB6E0?lzy)?MYh1ZzbY$ve@mxwOs5Z6U7Cqc-NM67ey};%0 z-e#w(o0^G3$JQT)`O`o(rl!D`F3fg}sT}0ZypNZnKiKueHn2VITWQ*7`Dcc6YSPMI z66M8FbrL#Kv42r;==Q(Gw@JFs*8|#2uf>?)dj+A{N-p{(B6+Z$KM{SYmv+xNho@*o zyLrjn{1fcZVqHs9{EqfY^Ito}V%7@+SFXsDljVJ?7&y(xeu3bGyCZggDoKf)XLnU+ z%|m`(&qqr;E5gR*e$)C2OwMMz%6qnDj&4^KpgN4r<1yjx!Z8!wbPj!EmmW9>GlRxT z`@vBv-r#O{^aaMqda@}?XR>=c-g30 zms%yc{cFtWY5DL7Lcoy?13-O`#Pyjy&V^tE}3b9zh?-wi-_@KGw&GW zRy4~Scw6)z6xz9xBx;*ZU*u~?==$%>yv-)l2xyasxfm~hYvm`?p}q8)K;p|)3dZ_#~U6ud7*`8Okc9q(~9et7v&82$T(CIHy!QlAjeMTOEarE{TaoEOA$>w z?=f>ORU{4Jx4u&i%Kj&r`jwy}!7X+ZHKjbeMgO1c)BmBXRypbYz>|Lj_ipZ*)+zhk zxS+wR(s%dP&1;LDS|FZ$$|8>53@k7GG!WLRRNeKxFiHV6HJYWHVPS3Wh z;iqfqd3kxS<)h!Q_vA{4`W)|+LT$UgKc)*f$pxFje6TERY~x1mYXhmje!aWrSfr8~ zmzGurRjT@G^!OfoT(_C`>1uLy%U0P?rU;#w4<9S*Hl}sAs;ms`XN{h1Y@TXiusVa< zuIodYV!lnc@oc#2?}l7mUFFNi(298MxKA15mg%nboOnU|_A_;iyu62*o~YcTF{;6A zi9lea;k!m|qp}YS*u!j_9Ojs~bGIzh?f%;fxXk|d?_WHVYIt-st*~2(llkvSwXHt| zedfPI2z?UYgSC%h0x!(F!=J^8**d;-&ey61wZGJ`DOSsTiibDCz@ek^p(m2k)E_%x z=mcYIJi#B$`O&!C6BU0P@`PE<9@Qo!E^cy5Wew%Kdnwslq?(?fW4YRw7;Q81aU@3) z`KcHeyR>8m>r_`zcyEv;?tiv{-t%1a*In;rylvF%m^oqVf3e?-&66AjmSgb}<4H+L zN#}nQ%SX?GH}Z{->-9Z@Rsq^aYUu)KVEIgHK797gtxi#p3DB0R1~)YRq8Wy;AM_>~{69zA-rchJwN{8d*>*xJMe!C2jP z5Y9)zf`^xbwM)O13nQ7+UG{Us%%296ic?4gwB63ZzIES9=$LhaU+Qqzx^GV|0E>qW zkUd_C;52EpotV%yt;E9%(y1cG4c?YdA~jKhCnvMo-nUmdu}3EdnK-%KYgm%KL*$NZRCbNZ7@hoOlhPwm-`d(L&hoJZsy`4$ML;Zg(;8;=~!D!MGBC?X>5Bn|D=L zQ;WW+1*%-wRUb|p@k<8<5f+NYPsbHjh` zZ$~gXF!F^Ecz+sLiERI4{Xy+?0S7Y@JplQ^bAH#v}1* z3akv8Qu!drnR;uqGIDGzK0f{#o{coH%Dg^DHjvBuYgb?!z^|~?#(9#Vz}hJ7`U<;k zJR&DA^2!gqzQRPsdyoYxrIZ21!!#~ua6j<0-}GwfIef(MypvQyA#&Zj`>?#ao#kGB zLqh|*VH2N4Ri!c~tifrq9YDtL@85siKivD*8A?LK^5)GCsTd>!J}E659967NcZvhEu8GHt<$*L%H~_k( zy!d^-3pdr*FKsYLHgX9QQ#{(4srNrWmX(z~W*Geedc@IwVg~wX>fHV8U@#yc0KDqF z_qStbX9uVxkPWx6Cq~p|ML}_xOdL@t6map=sPtw-Ky+}6f$$Y&biMq8SJkX@M8Q&PyQ$;T07XKJ&K$P(R3NHhq4&24JF)FqAKD_zk*O$A25?3eYVFIRsmsq)QqWHMD zfR2Q?d^;2bq>*Mc` zDHC5+*JaboE#0{$hcTl@w@qZJW^oH=@^<;mJfA0K9@qh`oXO$TLd}?d_{Bkgc~y%N zOPKiOk)~`!MmEs7PnS1~vyc61-YCuuUC+aOo7as0n*9p8b$n!hEo%*akg$CtZ!j=^$J-f?QF0e>d>j7nhA{cFMNkaj|5ihXja9NJt0>Oj_pd z*qWK;tsRq!?gbf{7IqZKaFiOei15kZPc|R|?I;=e;1)cIZKeG%Hyzx?{w5X z9b>Jc>gR@dUp>R4^u-G~o{!%1b|jk&l*(3CMK5xE-}71aC5(@2!KxE2n8Hk5C;Adu zu_i1W?Ch5a^?)VXL%z1@mqI}%cuvCu)vXxeQdFGnbKDWsa~Jj8)Nj;3`o*GEfk%{E z{Ny={2*u)pODjUvbGx#+g|w62xiKMh6_vc6`9+{I%8hcu7cQ%SVn7)0n~3E}A|9-6 z-V72krcwWco+0LkPe-zekK%&|;7188blsjSl&_y<$8m0CJ_3m;kIJ~1bo(C6OqA;? zKP$>mhq=_Od^?CVt+NOlH&&!K+4}vAQ?ZKqtCu&*#>x-u%ve}XBjTapYziU1efxI7 zFZL;eEIEMv`8X#(H3CS|YmoedTUl)hjEJ>FU6WWl_FK8Wd?nKyUDub3*Q;x5N-xX! zo`BSqFZ0$|Kr^kJ3D!`P^-hg^IVfiWbCng}o2}&E)SUqO6?&^yeYtt70bzmG{^>eU z!tf(u)}U1+MFl@5bk}VDr?bm*yQ(vQZeE`b2LffQ$&;pJ2-eav)1Y?;Re;u%$%nS#twJEW@W(XKNcPV`|WyshO zhGG#)@$oR4f4@ z>AN9hVNR={HBmjm*@C7=kNOr+t)5P>MwcmmNqH*z=JEuMf~OqM3bX7vQ~v^#>5bqg z6_v=Phrqzk=)E7YM7{e$=^ckq_e#-MW;)o&k5N+8m7?jU275ht@PG%!#KQxoJ)Sah zjY8Hb3aOXfDU@0I*Oe0IQXuIxRb>pe5tvr#69ns|h*?l}$}sYZ>0YURy%mUk0yy!9)$yKa0ukB1 z;VY&~AVNdevs~f941@@mZeP_@jdKRUhoq#}!0@uXmIz^6q@DoTjPH_)OMN5$>fXHL zLJOt+%TZbBGuV03IL#j{vcet7kXx}r5qA-3_?uecKoIidNc5TFWUa%TKxy2kz%?bY zd_HeQbZ*BAHwVMR#4>{QQ(b_eOjYRTH^XH7(*(aWXu-JTW=9w>E+$C6ZhXSZ!hbD8 zgH^C&0|=RYK}rp`BRJd0QeEL(5}?D8&9Qn%jR1zO#L7QyFm|AS$yX&CZ}6mW|8kWx zF!t5Le+a)a*qTY36JOhrHtvkRG_<^aPeTG+aSBjRvEjrQX6ELMB8Q?8M;R|lL(WWO zMaVS#wiscPchoO1p74GIqO?~~Az~4b1ck}P{hfMQwh}}V5TRgY}o4Q;$Z&~{a;np5T4Q7{>^ zoj}zC$i#lrRrw6Bttvh=)gqT{P9eW!i4ku zIZCjPAhBl@9vBGiLW$=vF2?KVgF4?9>z$H8H!4N`0GRe7z(h&0OFTxs0L8gs?5tSEZW_c>BK+=BO+UXj^M-fX)Z%_#wzg%V zyD89!@bEb12IPH)PX-M(vFmfn{&SpdW5E z!ESSKEN2v6T6z1)QpClDA8ys>aB5C*ve>Hvn9)0F(9~|TnVOHmR@tA_|A-v`C?yDH z&+P;>8FQ}IL&|Ms11^Ry;4S4c3MTce3cfGBw7x1Fp<2mBeM}BLm z)-Q15fMz2?36HUzQEP3q9rUqA!wv0gB{8N5f~Sj+$n^1M-I>spFMXDkz2)z0p3O?V zD-lX;>r6HcC_PDY6~N6cUg3Q?@=_Ns7bKJJ#BPqs^A!0=Aa)#~ zt4VS`vRlAFcW3I0k-z_NAQa0zxggBgFPv?AUzB-grAfss_Cy_1ul8dCZ8$t3)789R z85kJedTzw6$-uk}XLS=N6=;|$;Mc7T`o7`EX4HIrIbLTe{%-QC8W{&nLAYed5) z6a-6$tLsPsg@^`Jg6;@;lja$k!SVettaxt=BuqU6(cDGfIKy&}eaQ4asN>XW*&# z%5LF;4{9$!LKLg528gdCGyYpNfEDeR@I+kFL>X6 zX9XVxbuCUP57>_|rI2?7GaeU9Tq5QOpY_DhIkkOGm=ix;c>>Z^ludYgaMWTCZ9PIN zW6L%G{wq@Id;<{Z>x5seH8r0A-2?FMc0@ zyIA0w*!9KX&@zFHy!^JddH{Ap7b&&WRxngsZ+SjetZo-Q`LcTv;BXqXVz zr-Ojrv%NMX`?ew#4A2>Kt1ELyXHacz?U~`4UEcke(CS3g2Cr=VH4*u(gDj9cJoecP(y2 zj8Cb?K}L-DnZo`%UaN8J&>+!+ucYE9Ij+}8oI`=+yLx@O*#}oAy%I__1$@(h%ye~i zUH!}&Lq_;)C3Wd=x)fE=q)@%Dbh{F07en0Sj#*J5jARcX9zTD8ukvHW4NOd`PQFXJ z^!4?*pa>AmblxkEORWhXJm?!3NC>TPH8mpqapbeDc&C+ty|$QYXmRCkyNhmMpLq-l~2Fq4wRGY>7@&tFH}yZcKj&`#G%a4&jqM& z)&(~Ltp^}M>!hV}TdzJ_O_AT03ho$OX^(50ULRW%4jBE}Ete%7c+yFiQO^q*Gz7@2 ziL)l=op-wrzf?lPLKHLd#!qA{cW+2gQcdI&-c)_HvIO*~(QPcf`%1L^LaL}d04HUs z&y_6`nT1+Kc~_`cK092m1F}3JE6edc;R5ou6k-zF^Xt9+7@y+mQJHr63*`c%Mzih* zgcnERufE>#{lWY3_g&d+QIcYn)TI|B3tr1nH^9m4ka)1+a#j5F2pj(Q<|gu$m7>M` z5%)X45!XvtTIxO{oo)^5tA_$Y+s8o_rH0LNTyB$5O7ijCsI%;Eqmu4cdqC+Dh7PPY zffX+v6dOX-d+icXas zqP5_VxR6RAmy`lS()D`Bs>l`;GkfuizseT%20JCLT;G_L zBjZ=W+#W~hkM=8&eIPFDVnYJkL_%QJkQIRu{?x-fX> z*d70(bTMeO->H&xHHtchWnPeop=GK+xN zP~PjAKD$E`=6p~&%aK)eT9yMp_sx+v*9mTQc2gX%Lnhr0RG$M^+Sjhs14fQbBc*4^ zpx29w)A>r{iYy@hJ5ur>_|R3J$3aa3dm+LZIA4)A$acdv*go;S1`WQYZSWunm@99v?pJd&vm04HsO@vhSJ9QNjp_M&nEgfOCbnZ zHnzNj5-*^7D}LLc0#GVS`PZZp7dgq=iiF5@OBvsH)A{nG!O7sY!Sv#pWbAT`MAGbQ z7~*GJrtQp!^SU}7n4)=+dUgO{O-{{tj{oi7<{r-qz0+mq0f}#GY$Pf&<1$Q6xW{km zbUqA_xUMJa8;J%CQ8TRkMD6;v!u)n(1tIj5{`H>Qad(pAYR`G~9^5+kn^0ysT%3^b z{{3w!*a2*P!8}a`@UYLN5O)*E74tf7*kI4Hfb#N3v7%nClyNVhu&swOMz2c@R+(?5 zz|?aZ46n`?uamyS7C3bC4yI^Ki3qmt)b$_fP#!Ujj5XTn&U_s9ecKxEe_X@eq#qI* zx=qZ@IHM+(rGtHoz%TG(KMgXmi!+O$dvW+gY2VmZxFD>@^6uT>)FqC3jW)gyzwqQs zUZNpB#3x{_ni$@SDN`+$hvFxH@AOKfw@<(9mcZ45;n!Ebg!P$rv3^zDjz~FJpO3+m z^n<8kb|RM76HfTj4=LJyzQQ4_h52?L5%|*KFAo_zwVxKDSdyD-GBzjTH@WYV2{@rD zbO++@cg24eY+Il-cWDt#C7dnH8XjT}zJqYxe#Pm{|0OT8LlI~+IN-mFdBS?@qn=($ zM~=gd3x;9=Ik2(^q1n zxU%7IUk;jut1H&mSn2%5l$BS-^;m;4e!2-j0qXZG+r`l@zGu(4)dS*a6>|qIonqto zmuFvP>^U`y!+f%@$cy0S8x=iXUQzr^tYD<%h8<6vgiaVTqIZ3GEfwuLCxnyO^z(3E z`TyQ1F1+Ah9{ zK@O} zbw=Nb3av@=N3s;_I_@Mg0kd-ZG{Mie=ZHW?K(w}1$zSq5LFs+)^c6L=Y<9;+KJD?i zgZ&NdmzDi`e$Ww2VAt*r%FRUmiTBZrYW&eOGFhUYElx&EyQ(^i~CH%Kf zIm&0dvWH`@F(h)<&|PQRyWhL4psDvS*;GtNa3hL`mzRK;iUBtYfW}|MF*x*K-gQ{W z$K|Z8yT|*NMYllk_X1noV8Bs69YWkjXAab4-*Kv0#3I1gqdGgSOUX4NcUuZHxZ&mL_b)WF6bl>jc@9U<|o|RdJgUG?p8d^N6pHmiOuLM|0#jFul#x3?FqyR z%REi0=3HKg_x1kMFQ4L${kw&k;rmI>&Uq*xomv$S4-fZQ3S+)eI>OEHjl77gfHTPX zA`liPE@^U9Cn*{g)|>pr>o|pK@d6?tj`q!OoA- zb5Z@bqMg?ZnFewQ{+P#z70s-@b`L?CmEu57^%TJ*pUJQ@i}yTl4kdactED-ulf${g zOgIkW_Jc|szI8lH$Sdv_g?q%Qtqo^a<3Ng5$4cVCXMb)4Qhh9!fI!o#%F{LPhgs$> z-op}L6BEb1p65pjd?|^EmZCZx;m=qji$%GU;^Oj}m6Uva%=e)`E{y<(08lim9w&h9 z0{}k;@etv`PM?3A)bTUHMbmVJ5rIz687`J2o%{a%esV0Kh}*`e)kNJbhh6k$q6Y(P z^Lt^|#;aYZ3eijL^6TB}OL(PWvyuT2E?i-O&qn%8Em9g`J^;=EE4$2YstS3))ba20 z9fBhP%xHcnjPz@V@2wcogFmt;*X)wNU!R+dTwK{z!*pCfAk@WAyTmH^|7&WQe)a`r zH9dJ`Wnn?V?2i~L6fmgc8idLe(yz`~XAcezM#aPcAxLtV9Z``i2`Opvq6;A&AhF3o z%T$phd4k8^XmK5l8Dd8x(sA7)F_do}@3y#ai@soZ?_^!TE$RA-h5%Hqn3-p$gdbJ| z6deG-S<01NoB{g}LDm$JAOG6u@lyON0uofP`adKNDK4mSXOZS0R}kfu-_kN0&rVYh z>Z418rOaDeSv9R_JThcLdS#S7VrD ztzL{3!Chw{VxuN_Mm9_7ng2aH`o?J=uVP|gP&kNRb1b!te>C*LL{&A;2+*~gqS-Qv zieW}Jgd{-TXwCI9$sZ3nEOBjAy|~)|8H<$1Pr7r&@Fme>)M2g(L_3xdHZI!z4bYJ3 ze_8JM%&NV6!+_+?iho}Vt3Lt~-#%Am1LJ~reI6T#MSPDBf}n76#%uZw$VB3BfOkmQ zXi54x*bf1G^!La6Y5uMO;>(*f6~Fq}A5gY8ne-BIX#)RH$1Zf8wzM{0ELo=mK%Dmn zRKs-UH(9iape$mhaG(IHR2HzxwYtA{A=T#nM{%sYoIEa9xiZA4QE<^u6Wk3*K6-Wr ze13(N`| z8|IPa7jl({iqnx)UI^H3US@+55RTg+Ulc!(1D8MeSpVa2(iu5kJWYG2VrBdiT;DeTl+kN~H=&z~_rgWt zPltg=XQk@l&EDa}H%e|$8=tT7tM`4H0t1b_OhB3b%CVZFACTKmu?WPtmMM`tiNb$? zeZ%R^$r#3$zwR_N@WC`r(6{g0k)M5I5@+uZWMXOlB!vr#bxsh7AFzagu~O)$*B4C| zKM%Nt;5)W-!usKMWM0(IyJxcw4qQNi6rSTm%^IRFnJ4#YGx@$K+Bm-a^-FJ|!#nb9D1|C5>7Bxa@;Q?8aY~P5oUmW!vOqX{ar-;B|3% zP0f3?2!@?G$5vGXIJ#8%!5DC4#iP2G3Xn~x^J98?`u{+k1mMdl8L!C2hqHT&&t6kf zQ?qK*lUXZSylMV5nlB$5988RF;xfQ}4v;N{mzDZ$r+`ll3g!HI3z9PjWOshWd_&i3 zg78!z8~o|K%+a#(YQ}IT)D*~OdpeWauFkd(*N1TyQujdAHYQA(&!}%`)t7Q28(Ym= zxj%&efHaE~0t!wN=4*j;e!Q)hHt@n3R8JLoe<>GS+se$9U6O+3Rx z1?%mkpoR@A9XELGn-x}Voi@p*#X7a^_W*}@5o1fWy|k_-uVNm+xCIRFfgBXVdD`_E zFz#2y;{`gpy3{eZokr*%VHhlxI$(s~vJ(wRgTr!(neg1KL_cReg^Cj1PbB}L;j5fB z3Pi0yLjQiS(OCeWE?KH+<=1j=j8k9AC(JzbAc8oxUXlkULHdwPxr={B zZnqvBhx+N9@2g_t7l);y&6JgwSJrGh=hYfQa@ucQe7orgSG~=P0j)NpufnAG1-D1@ zdtVFqEShKAXq9~<76vOuGBZ91=B$lh^Ov7`=D7y?4>h@~OF1%L)Dk(XX!v>M+{d+U zDp<=*@m{1!;69M12Lkq-Ql|n38@-I!8RAXT10h_IvMGpzBk4HRCtC%vQ}BB@UUn$HI3)-zB!c6&-4 z;sNv6F_`?*`f*Y1sq(T$gR?QZqh zXNA&#(H{rGTE-9-KJM|(-M>(ApFC51&miO>ZN()4B=3AhLRY7NQCCVolPU8MiD!3F zG=nTuW<+TcDK=(G_VH=|hmqX0%~k=5M=VVr_sPh}{CFN^G(1pZY({+=@QC}|$H_wc z>G~2!O-gF6qBHK>tgEL4`g(B-nU2zG(W(i$Mez zvufISnY9~VmWYXx1P6Oa_!tFmTEXQf;B3kR1KMCzFhG;>$4cJvMz;g!HUdGkcE`X@ zbtzu_)Jcr5nLeqQ6|5@yWHXYIci!nEsXt&?A5>^i{RJSM&jwl+-xb0Ur3-K--f7f_ z1SgU536@6S5jtIbTHr`ZG9%DhpiroiKX8;{v(aY8ALxWVPefRoa4b=RTmWB){V(#} zDqyIR>3W6XZpr9ZEQX-9nptRBr z0|Jsm!_WgtcMRRq9nv+RNOyNPLrF7)Jm;+Ye%^Q6{@eS0c)mQJ*80M>n62`TPt5#KyVVc0R6~bpWR)R}C*O%+U+4_a=}$eQJ?ZZ;H53T4K7#DA?0Zw~h$>nR>NttXR3G$Leshtue_yDX2SJ4Ro_; z9Ms>d3$Th{-4q&*e&JASJFiCT+?fEVN&R8pTdTUwY+uI|^Q=r$nc_VV(bNdu_DfEb zn+|7#;!oPi>UCi=n3kZyct`tw7fk3?D7Eme({-j#cm??LvdGE=gOYB+GcbkTg0~#j z-XDy@JO3f$-1<2jPIgl3$*CrIw%|3_M(|IqDiEA$EnqtILauG$MDhTQb$2 z8_vKw^ni^0+=_(v#v#I+Ke@Nl#i0Y=2eF=-}r^wTr%#NBrNr4fY}=s4y+~ zmVyMULdfk2aMtR<)GCX(SdBQ6LCk#>upu!tQS`sNsx1_6g+p2BKNVLh({K4$1HtPI zEcFu-l4Agd)qVf|GqNQ4wVtOoG=MvcceU}`Ww`Q^^snkWLXVGJLZrzh+3LDGItH{^ z{WkUD@jm6f_ru2?CXkM3EqEuZ*$v@0lh(j+Y6eK%a?_LGIw~FbvC5=gC-n+}*IEfE z_oQthjD*tfb47+#ABArh1Hu9vSr@M|Rb^$#=t+Qyx*nre56bL+OR*qslN@A59{vIE z9VKReAU_Sta!`|IQplDt$(xy>HU=}YC}bTboNGrIw`c3s_Io-b>9clz826_f;6bXV~X zg9bu*57gA3G;a`_Y=VC9#XZIwol>}Xc+4QZC_fLWJ2okY)qsKKs_Ao;$7u&D zKuC0w?;0$xuhYYH6z{xLD~*`5v8E?45jdjjLPWm2a|6&^6^QQ&`SOD10f^i+FafsJ zq4~t4^J#haqZzp`9ytw(!_IWIn)%`qA*GblfxJ9QtWnAGp;Vh~oGoIfo#6por;?3} z`@gjai5huP6gd_Kl9tm39I2xJ-cVMMK_?KSpsyWo-KgNVu%N=cs_T5V=$D-F3q+1l zJ|*fK6|A?t!LKO*b%D_@?z%e zje#k`hX5k1sRQ$;Juv!Srwbxu69Qn|ts53H)2R;NwVzsgdU_zLWG$zv7QjGuzJH^F z@1H9bJM7I}0VwbQh^VumH)TVwU!o5MQ?;pXXc7X8C%`me0D1!5SrK%sP~paRmjC^j zD1CWy@aq3L3!fK6Vpp?MHLU|=UVt3Bfe#2cv-eU`QX(S1K-6^ZW~t`28UtkkwS81< zER#tdGif(wzyt(q@Jmt>5*FRYnfZBL(^4Iz%Vw5eVBq~$M?hH>oW2Lkr~=;8*S5hn zt-ExxXW)aq0i>M_Yi*0OGg%^lkufxbE1&_$*mOYrzt#}hdZBj-hF~k2)7RuwR6?dh znSihbQ*Koi6-LbGv#(esZ3govRyMZ1F)b@t05(MO3$N8&!_~zp!QLlaXyDPkVdc#<&Sg*r&|j@w#80_4M=rBAKANX(^Bi zQ<>iRA22iKsv8*GxPpuYQa4f%_Qlv(Ml0QO>?Jq1D#(#nC)<-s7(c@I42#D1XFwIf zur7x?!si1YDg`y8K(~3| zN9{hKt)i~pF##SicLQj0j~~u~PLvE{AK^zS!xJ|BkuCZM4b`&_)1WzZ`Tc4g!Xn0S@jAD&Sa%g9cEfwNF7k zFZ0G}J=u|%tr9wJdG-ec;Kc*MgJeTPLojU#Z$S@APy>8g5!}MB@fGJ^t-<&W!)noM zN!#e!x!=-l4JX2x19UU!W_G;iyeiVL$c7`@JbD0c=h9Ke78v=@lB zYBHbQOJGg_oeCu&w!s9W7`+dC37yynejj*=P8c%hQ@|Df^Xx#XyZHDHdha* zPH)K7)fL?v0MFUz9)n5~?+Nb!9NiW|3A(wz{ctqcC%pPCcTZR2#7XD3n=1 zsQdYFs{8q7P9Q0t@V9T@0vj_kU+@(Jb#o3rig{Z{$cOfYBg-%z^%-jxH~N7&zW zK#PO>-o-D>_4(&l@VA||Cw}bu*?~Aa?ha zM5}LM7{IYt_wLSSV2lSi0fn}9c61L_5&}LDQoH^6ww50k_t^BStp)=Qm-)o&-W^~r zSfWyw9yS4J&)Nw!IH$<^n;2Jwtv={LAQ;@v=alFxAkY;fA37pFnfyp5x_jar6w2nY;+oIEy?RwN={RHKhdG;%o;@?q1qz@Uu!0bk zOF6A|o)9fcdd-2&4wm1z6rej1UyTn|I$ajCyv&~!`AZ*0aMSg!mKkJ-hk!TRJ_m@R z-kqz<%bEU8P>W}f{RG_mwLHoYxIKo-Tv|!g7>d4e^5WdNLvBU;?FdwR?9egh-bw`p z1+6Oc2#yk`mozl`z`rpR#~2_FHpsg~@plu?Kr+~~wY5#p$NBQ)@7>uYtUZj=dWQ7{Z1E;N+qs1%)OxEb{ z4H@bIPr)2G_#GXRtujMnEG&^jQ2IoiigOFK0KelzXkp`ZFxB(PaYg1BJ;C%?r z$R^#Gb(|m7#?XxGmVQGs^dYI(^R(;3=qw?$v9@;7TFmhVn@cBMEJllvP8N?$mudfV=f+Su$&zw%*QkP$C)W*N5ICcoQTEnmsRanf*=L@dcC)tKEN#;u zEnz??5RZh**(b^{VymQy)d51-{U9>+vBx23VC-ydr>d>kij2WN2{eA;iMX=4I>nkO*zCRm{nw1 z$h*s67Da0uJmrmqNtO5d5JSG*y-V%1aI=*RgPl-(v{uv9t2H=6fkFkN{Dxh`>vISoXfJ~pvmm9F)m?7~+K)lpyZtGGT49gqT(ig@ z^6St7G^dFk%T<#(#@pL_d)vH~yEtHt`#A0a4L|>s6Ga>7>ol65w+oQkN@uN(MgEQ1 zHZ_E6f~T$r<@Bic6e5W_#$fC?pb>&n~i-5Kb5WTGe^K3r&wcXI<_O-}GQ zs^$8iA9KjctcHf_KmWR=0dxjTvitazHRCvq=O{}*DEkGgZ76mtu%Kaz*Ttl{9A5%z z)=!)V?HJ`AX#r3eHXCQh-JVGJ2p$J}04F)tf``w`T$&4X4@=H~$Oix{wF64&xuT0Wq!6L$O(whd4nIT(@f zw9?g_m`%zluR6c5a2qs*gW6p1bNhfl(MDNln$&dz`mQP+R8KnQ^OD3|n3nDJ=yCmo(=?Z#e%#dE2POrhpX+8>57@qp1G`XDtQEC%3 z{IT>}CmVyy7{A5Qu$RYVEQIR( z%<}2o$#tZhkc}?u^P`bGrP0pg!d&gzby%;3eFY2!5Q#H=U**1P1vpEm$&> z|NOW0-vg~xZz2yA|9V+e{|prR4B+#b4Bx%GwG7lrmjXm&B$(i?G-^*_uVbc!d7y5c z&dK4}_ zQ}=R-4Aeoubu@A@62qdk?ZMmsbT1tgag&pitQ@7R=!72!)tvRXg zE?}HV;g(kMVe(qN-l6E15$N)X{_f1yp8~vVw#LRlN~#l3VZplJpe|G=DEqmd-(e$G zZVGQ}pSYCkPt4l&3j+U9Ws*)UDaLDiJ2gcvX##QQ_HAI#Tm)j?4p2LAadC}%;%p`j zWBIH;zxMLkXOO_$HmoVeKPjB04PXk?_LS?l1u+3=55UsmoHTK8aL_TcKNc20s#MT? zWvULmMePEUJ^R%k`i3-B)+JCpjk)hNHKzb>g~xpt5ATU-Mg_^xi@21OU0#}?*0P^Q zAei|PP*qchtyUV&@BMyAMG3e*0EUT_c$0{VtU^!u7Yyh+zV`%-;w+PM&AdCEOqDx z$ZfMv9cR+w#KAvUev-$3W@Rz&R0qVUYTyI|Qw}HI-0bY5qazHh2uEj1MarfK09#$( ztcc*u0toGI{&s+KQNS7Zffu7;>*E7=ocAy9co@PZaArpPpJIsOrk+=!4w9ddvGcR0 zs33@45glKEr6mChmPR7_?*#k= zr5Z#85?Fi_}(V$v6nZN!!eufJ?RjjR!Sw8F=xALoBad0T@(E|Bg2ybz%FWD8G zI*gpv#{zma$}FzP35+pr6)f61`r9SQWsxu7po5HiZiEfq!p$@SHz4R^rW&A^R8&+1 z1O9ZfW?)oY04c{#S$PChEnA+Rx8xcfK;8%GJ;LM==##sY9Rx_gPzzs7_Ghw4n(E;h zg^z0;1Jm&ayhW|o3m+U>TYb9i!Hczqh6V{L=M|7W*_fD=G;8T(Vt}*tV~PM8GzlDc z4>QS6R%3M=0W=S6-d7-!NPqzG^`3U-&vAZ-Z3YWpV7WX8ep-shkJYucnICWsQH_SL zWdr1`#^d@g7`-EbV6c6dBNK52PN2okCv}z&ZfJ8*^3?Lig1Gl$eN4SHdN zPyS{F6oUBo?kSi@JtZxaYn}qTJEJr)WIcPIq4d(ZKN}mUi>7K%J6OT))MuK z%0ECXdCqJH2XA{m8m$_Ajny{f8Q48l7?R3a3%M3 zmVjgD`yg9crW<&s0x5NPNv~nHZYDM^W~jDXR#xfa-9Z#;OtTi>r8q16Z}HZun+9FV zWdwmx@*gdrd6_8vYBj7hE`l9Gtcx4`F=@Z2oFJ5%qDb7US(t(OmF37vdrG{Am8hd| ze^YKOtkfAR(kCV*n9>#yTE)sdX2N_K~mn z#5La2*EHF#mN5iOq*$~P{Z967Q52RjT8DO3YosZ;_`$)Hd^CMadsgHErl@;c4HeD9 zcecn_I>uNTFMQ~NQw1i{8OCOk^z-c(kY-T#My^hMg+g@g*qWqhZzI;%PUTdF4wmA; zzymgxiB3DL8w*Mn?9cEvnSM>8JGG!TsAL?5o__v%?b46BA6``Hx>HN)yS;e z+?K>axJ`w6LB#7@f`b)w=L%l^i0QsQlX&pS|41XJYWNPhsa8?eSg%YBZ@Nfg;L>)* z5zTRlyo_?Lh{T;rv|M+V3{T1zFQd&h>SrWT#L^UMdH%bgaJ| zOSF}#do{SX(lnqBwa8&zi2IT^#kW@?-@cvS)bpRxXS~+Z36FO5( z*KWCRUUI0VgS&|7XFWw_dwKPlj*a8`V2KCE;xHf87wcpcbFJJhADw;vsy`cmJhut=yUqLMYX zwB%JwzQy6lclG7-=^3HaJsX9^#Ta=s4RrsP=XTHWqz_4P(*%#6_K<&^B$@`ssWNG) z<}kLF9ASxV6=X zk9?~fS5|Etc6JXSvw>Sosfwpr@+XD{zObLc=w;fdd}M(!OT~lt>jJN5n`Z{jGBXKn z;It#u{OaM6wL*~c9LvwA-=vliO9suWE%|;L4LtO4c%y!yOmi@rkzIt0)VodaY-p>h zDR3_C_)HvHWU!mKu$Y1;`IzsGP@97-@iB^I?QPg+=ydj8CORwxPf5C(&B-Ls!u$tr z?B`B|XCwIAG*BT(_+cBWB3S~$_S1j!kiI)5);#4cR7}L@Fu{BCQ0ZKA-pNg;D0Iwy zF(Xx8uKem};MI)7LNgiO;|KxEFCS~@I_6W3R)*F#AnM1TB|@bAf6#3tMAh*L=IF2V zw2N!3Os6JS+OKa;(JK%+d{nM!O`%$yS?Q>qgjF=VYrYi7bKmv!&qNm>Mub`2qWu`> zLv$sbW^!#ZmM^CE1SiLl=-SD|{%eO`@nb31U17R)Ywe+q#}{16O6PM)+lAXR&6+%t zv1jCmIbB>8Mm;IX#VtU0?UKuLgeZu}j-4NEi=Iw*4&!B#uGhQ5Vc?nI7a^3HDelK7 zeKUFJ&?-O2g5~gwsYjj(r~>I7@{l_85q(?tW{>XQfpq2^%I`Wjia22h{7oJA4pW~P zQeWChMTl9NUKqZr-tC=FNQ1Kq)Mf}yHvL(lU!xc6kjv@QjDx4Ayj`xdiU=4so}prK zR_`36vr}8C*+xuTPyQW@ysk4VJ6GE&eE-zJReNY)1J|#H#~7+wg){#9@M18C+5Y>^ z-+LvU%J)x=j5F79UiOy=Qf2r#XNR$-wo#4Q)Fq&>9sj1)CSpB8h)hB&uj(^6sGVo=+e6e9PS2&MIQF+a%J>PA|%M0pF?{||i=S4GLHA{Sq7jm|a zJCtBiusP5b6+K6YnbxB|a;33%4*U7uft=a*@Od0u;0+t}>REe{%$}34~oXFYh>x&24KJP}oENI(>F(&dg)ukj2}jeM#`6fsy6(C@j*okDd=mG1J)>fNO$vu&<@IdjyU$KT!NyDJtlEcn zYuDKKZ3@U(JMHJ#6jUnQRKjdj^B5JRp+~M!SJeXHs zIj|M8pqdY(GEOUwN2B2ZZ{u|HBjYJo;zO*_4Z@I5Ft2WckVJOjm(6_dRjC(H?WvFm zNWoHpf|YgZm*a$nehB1_*vn60wc+ZX&FK=dlB_~Cl0<1d>$*=vn)wKmP(`|IFi^;o~}`I^BQI=3Xbb+5Nsw!Wr~CB$dov$ zS@JWyqw(H7FIvybt4nAjlaT2L?@I-DYiQkwohrlg#R&F&T7%}xTTfU2{QT3h88&Cx zU)mL9Tb^~Rh$hqOa^QC5#3D7jZP!R3!pD@gzxaD@jY(Gi7b{EIKGp(#^6=OC)=?CY z7oQ}%lGVy>V&gJjOqU9XO_!HBbRII7%6#b=@a7HD{hn$$M*7Bjs0YVy>Q=~*S8eSb zw2x}%^hH~1iD~K0D3F#nn9Sv<}HZ2qdRgnTYtN78MF;^cI7Hfmth6mz8kbw4k!CPcR@c z9HH)%MkfoGoQRBY!8eq95v_jS_P{?V;O_lE=>#F9+gx)9tn!Ob{%8owC)!x+?5p=p zky@q-X%}1QN^HvmeB7XbFuX}v;|Rn4=LVL5SA;e;i=a_PVJ|JyjBqH27flaqOpz)X zWw!W?ZMzpIbqu@5G_s?13pSf!hr9O}BhAu(A-rmB*G4l!f;TC1bcPwmdq?Thk^b^3 zw(^K3!8?-YVL|t!SI!nb8vdFgsSo5(Twf~?ta`tUP!bpK;IYz0@@pZ9NazlZsj}R} z4CHczjD%m;795mUcR{lH%p)I?5oW&3>9l3)uo?$@UE0<1*2T;IxQH)occZChQdp`L zDraCraa3z;j^nv`jAN5Q+R!S|(J%SgvqiOcP@$9J0;)2#kBIJ*8jZbR?dNz15m7)H zDtIuAJ4AlyiVg{?I`eCt6*4fZ9Cmkhu9n_p%gQcQ*NjT6hgzjQsem7rnuORd?|+j_ zAm>p>ii^B&59#PD8YR-%DjcURISlg;`T?QsLYS@MEa~64clC6dm9a*Phbiw^|6Rj`Uvbz1mP9)qKlAR)60jzLtd`aIm-M_@GC;#_gEzKj$`Y zy<_L)QFV=5130Y&LfmuG;40Z`&cGRQzzWVIccfGv<-PdtF^6wFPoyM(bLBp%rHmc%S@xG?fMz zGHN<@1YwA)M&`+L@jA;N8AiP1s|#c1R&Tjs0hFnQ;?Aq+?sb+f+uK!>l*6EbIhyc# z|GODGj50nxQB{41jKWf3K8|_5(jA?U!1&XytZax!+&6}lbedo6wkD0m>YwyN5+<{h zOuotZO>+3}=q1mDM#l&#CBzQjz#I=L%app^N0bp3BCD9Kd0zOHji_i}!^hZX^u$t=Up zqzGiAwVpA&bar$5o4!3YJ3snVYa@52uW!m+nC|ajhWH1g=|{2aWXSWRvKzQ5@AM-19_B?e<|&F=(8)maEK62h)?h^9 zd7GD)TwQ%BuMK?7pOEsrvAkl{+T+ok9i+;2H8zVRrIJ!G+s&prLNL$bD2nx3PrA?k z?k1UR%&$*aR$=!L`GqS<$SMh^<++6v;P?8>zV6s@6#zTR6Crmcgx?U%P>pb=0{M z*G?}gFjW{kPnya?pdP&)&soj)npDS@q)j}(I^lWZg&j;4`;c7m5h6E2W%l0=$tN13Hah$b_r{l1OD5lz$)6DM(agmdJav1Y|1Oz!2KA_ZtVb(OPi16Z zOQJ4xUbB)14lh;`FWQB;H1e0pnJ5RtZylln&5q}#)!h__-nA#KjUr;VkdzBf`(*+i zAu|1(wGHvz!zVFYZly1b;W3AOGWzPN7Oo|10xyTSk!2NbbQ7NTQ1N`3>QYq3BvXtP zi-Mb|hg_Yv-!z+|oq#kw6E1^L;$Go>YwVOmdZ{}3{5Vs_DXzKW*MrVwxV_%`*f;4l6 zb*l#uN@&*ONf)@UMRhZcfw{A%8o9ra=@Z)~sWImH!nqeB?DtN>T%D^^QeWhvK2N=g z#dj)mHk+DzwJtXIR1#*hh7ju><`{})`#4&3R$`^2_F{Y(O_9tR-q7#hLt~JB3yR-M z=2$_Gnj<&RDwnmty2J`jS+q8{*=1 z!Cc^|G(R&M!sQANg&HmOqGR#e$ELGU-={lcw(Zdr)1le}%3{RdSt=iP!8zXKXA5WB zrS_thiY9R$(WZ}d4aFV5Er)Yg1b3oTM=LK1;#=OIIYVl5`OoUCXDDXm|f<(<_41VC25yFLDYV zccU4nN?mcwzOmlPxBbFCS<&n>V{+N*JIaeE?@4_4YR43$NV8-z1p;uBd?)f47;WI} z_314xq5(e`zNLwrh$g_GMwXr_xT-7bDaFB?cUK`+E}bvtvB{2zo84kCoOCv zRa@?93MY_zPX&%kymC-(3ZEs_b5r$?4(gNk?h{0+!E8cz#_pmLAI{RzUwru7>*_hy z%VhhTo=z+eDTRgWpyEB!;x#s7eifvwG_G5xwk4`cyuSNNI?&&m`A_*oiD_+;-f6wa z>`VgjVs8H_E*?R(PocyyLV%PpO9y(r!ybyo9*qYHkC326&-))&H0)C1FZu)#NDHE zc6~-PY?!s9h&RGh!X&)o{!NZJR`~(`@hPryd%RH5*+%HeyV!EQ)i^|z~#odst-EK1Lr^kh6 zIN`<*bR`||FmZcw%V~h^HRpg=JaIw6PDWzNT&?-;_G;p3%tZd2C=2`hNX3-PEsoPr zYh@dmqWR{@{_J(qNz}pR@AM_{*}n_r{le^e-;qW`Yy*FXDwG#upu13Ksl4;mzan}f zuoU@mws5l|x^l9@Irjlo!tBOp!nT(q^r;?Z(xQ$#UPriiKUA7kV`I%8%xl6M6KaJ# zMMbx*@S{!KC19Td zd}MLdUh!H^L6=NdrIMr%QknQM(ZtV&R<@C|q$IguTj8@&_&8tceKyeY*6~PnqOTB2 z3#+p(LX%rxxXRF`^VI%|P#jd^c&!yg1#*!Hx0i4|q6^&b< z!e?OWd-_aDR6o7N>4Szw>IWn7@oF1}YnuN=t>1F7hyC2m4|G%%(w$$AW}Q5ucuY(@ zQNvRMN?tOd9!TX-;QG4mncAAXhH?$WMff`0mYEov_ z7$<^RPF5qF;=_d5dx+`<`p#GrgO0mqudLTddw83gt2V=*Z>R)2os{~O=eiBbE0baQ zULi4UEk4o^DJRposmh%E*Kfx)ZPI6|1ejkw=XW!9vp4Cry$Z7M2u3rxko{ievziyk zU1Q%l@s5#sy3$Z9m~>P!Rqr;|?2Auo9(OR?@7gOj-h!pc*fQsww`4Ddbx7i>Aa3%dR=fAIF32h7A(!8PYW0rRpk7eF2Ae#F0Yem zUU*l;{d21aMHzOi?qLa#n={h5f5^n);)C4}ej-?DM7)aFfrX71;nN%7J}u(YA)wF5 zFP%!fpuukOas6>Y()yM|joIZgWnMV0ZuTTWZvHHHicJ7BU69q{-b55x;dy}A3jPo=1Y&$87^q$&T7EG#Vj8B^{SV`?3xy1}su%-R+nK~VNAZuDQ?!N0$*vaXEY~zQ_g5lPp7dYuyK|Q9$E~ik|kRoKT52&c*YXUCuSxFQ9g)Tx%s@(!)n1h>cz#Pd0%n6 z^=wPpg2d*;g6JFwv03d7K*|{`c(fu zUUe}Vtqp$}W?t8Ga>+*!m>BhDDr<`7^_%@U@<-U*;y(^5rVi-Urie0xj%0Alpx9sd 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 + + + + + +GoldenFloat with t27: one rule, seventeen float widths: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

GoldenFloat with t27: one rule, seventeen float widths

+

It follows the AI numbers course. Every lesson opens a table drawn from one spec, next to that spec running in your browser; where a spec's comment and its code disagree, the lesson says which is which.

+

Course 3, 9 modules of 3 lessons, one widget and one t27 spec each: the GoldenFloat family, where one rule built on phi splits every width from 4 to 1024 bits into sign, exponent and mantissa, then the same split with an exponent in trits.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · The rule and its numbers

One rule splits every width, the ratio it aims at, and the Lucas numbers behind the 3.

+
+
01

Lesson 1 of 27

A float cut by phi

+
+

You will learnHow one rule, E = round((N - 1) / phi^2), splits every GoldenFloat width into sign, exponent and mantissa.

A float spends its bits on three fields: one sign bit, an exponent for range and a mantissa for precision. IEEE 754 picks the split by committee for each width. GoldenFloat uses one rule for all of them: of the N - 1 bits after the sign, round((N - 1) / phi^2) go to the exponent and the rest to the mantissa, so the ratio E / M stays near 1 / phi, about 0.618. The family spec lists 17 widths from GF4 to GF1024, and GF16 is the one it marks primary.

Try it

Run the tests of goldenfloat_family.t27 and find the one that counts the family. Then find which format the spec marks primary and the test that says only one is.

+
GoldenFloat 1: one rule for every widthThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/goldenfloat_family.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

Phi as a ratio

+
+

You will learnHow phi_ratio.t27 computes a split for any width, and why the distance from 1 / phi does not shrink at every step.

phi_ratio.t27 sets PHI_RATIO_TARGET to 1 / phi, about 0.618, and its function phi_split works for any width: of the N - 1 bits after the sign, round((N - 1) / phi^2) go to the exponent and the rest to the mantissa. Its table verify_phi_split holds seven widths, and all seven match the family: GF4 splits 1 and 2, GF8 3 and 4, GF12 4 and 7, GF16 6 and 9, GF20 7 and 12, GF24 9 and 14, GF32 12 and 19. The distance from 1 / phi does not fall at every step: GF8 at 0.132 is further than GF4 at 0.118, and GF16 at 0.049 is further than GF12 at 0.047.

Try it

Run the tests of phi_ratio.t27 and find the one that checks GF16 at 6 and 9. Then compute 3 / 4 and 4 / 7 against 0.618 and say which is further.

+
GoldenFloat 2: phi as a ratioThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/phi_ratio.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

Lucas numbers stay whole

+
+

You will learnWhy phi^(2n) + phi^(-2n) is always a whole number, and where the 3 of phi^2 + 1/phi^2 = 3 comes from.

phi is irrational, yet phi^2 + phi^(-2) is exactly 3. That is no accident: phi^k + (-1/phi)^k is the Lucas number L_k, and Lucas numbers are whole: 2, 1, 3, 4, 7, 11, 18 and on, each the sum of the two before it. The spec computes phi^(2n) + phi^(-2n) in f64 and checks it against L_2n for n from 0 to 6, within a tolerance of 1e-9. The 3 of the project motto is L_2.

Try it

Run the tests and read the ladder from n = 0 to n = 6. Then find the invariant that names TRINITY as L_2, and the tolerance the f64 comparison allows.

+
GoldenFloat 3: Lucas numbers stay wholeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/lucas_accumulator.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · Why phi, why three

Why the split is phi, why base three, and how a spec checks GF16 keeps phi.

+
+
04

Lesson 4 of 27

Why the split is phi

+
+

You will learnTwo arguments for the phi split, and why the spec says the self-similarity one is not an optimisation.

phi_split_optimality.t27 gives two arguments and says which is which. One is self-similarity: ask that the exponent is to the mantissa as the mantissa is to both, E / M = M / (E + M). With r = E / M that reads r = 1 / (r + 1), so r^2 + r - 1 = 0 and r = (sqrt(5) - 1) / 2 = 1 / phi. The spec states that this is a defining property, not an optimisation: maximising E * M alone gives an equal split, 7 and 7 for 14 bits. The other is about rounding: round((N - 1) / phi^2) is the whole number nearest the ideal, and verify_7_7_match finds it equal to the published split for 7 of 7 formats.

Try it

Read self_similarity_proof_steps and count its steps. Then find the test that says the AM-GM split differs from the phi split, and the width it uses.

+
GoldenFloat 4: why the split is phiThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/math/phi_split_optimality.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

Why base three

+
+

You will learnWhy ln(b) / b peaks at e, how close base 3 comes, and what 27 trits are worth in bits.

Radix economy scores a base b by E(b) = ln(b) / b, and calculus puts its peak at b = e, where E = 1 / e = 0.36788. radix_economy.t27 writes the neighbours in: E(2) = 0.34657 and E(3) = 0.36620. Base 3 reaches 0.995 of the peak, and E(3) / E(2) = 1.0566, an advantage of 5.66 percent; the spec bounds it from below at 0.054, or 5.4 percent, though the invariant is named 54_percent. In range, 27 balanced trits reach 3812798742493, above 2^41 - 1 and under 2^42 - 1, so they need 42 bits. These are arguments about digits, not a timing on a ternary machine.

Try it

Divide E_BASE3 by E_BASE2 in radix_economy.t27 by hand. Then find the invariant named 54_percent and say what number it actually asserts.

+
GoldenFloat 5: why base threeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/math/radix_economy.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

Phi in sixteen bits

+
+

You will learnHow a spec checks that GF16 keeps phi, phi^2 = phi + 1 and phi^2 + 1/phi^2 = 3 within a stated tolerance.

A format is only as good as the identities it keeps. gf_competitive.t27 holds five checks: phi stored in GF16 against its true value, phi^2 against phi + 1, the sum phi^2 + 1/phi^2 against 3, a round trip, and a sum of 1000 terms. Read them as they are: the values in each test are written into the test, not produced by an encoder in this spec. The spec checks the arithmetic of the error, with tolerances of 1e-4 and 5e-3.

Try it

Run the tests and find the value each test writes in for phi^2 and for phi + 1. Then find which two tests use the tighter tolerance of 1e-4.

+
GoldenFloat 6: phi in sixteen bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf_competitive.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · The small rungs: GF4 to GF8

GF4, GF6 and GF8, the fewest bits, where rounding to whole bits costs the most.

+
+
07

Lesson 7 of 27

GF4: four bits

+
+

You will learnThe smallest GoldenFloat: one sign bit, one exponent bit, two mantissa bits, bias 0.

GF4 has 4 bits: 1 sign, 1 exponent, 2 mantissa, and its exponent bias is 0. With one exponent bit there are only two scales, 1 and 2, so its 16 codes are coarse. The rule gives E = round(3 / phi^2) = 1, and the ratio E / M is 0.5, a distance of 0.118 from 1 / phi. The AI numbers course opens the same spec for another reason; here it is the lowest rung of the family.

Try it

Find EXP_BIAS and PHI_DISTANCE in gf4.t27, then the invariant that bounds the distance. Open the decode function and find the two scales one exponent bit gives.

+
GoldenFloat 7: GF4, four bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf4.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

GF6: six bits

+
+

You will learnHow the rule splits 6 bits into 1 + 2 + 3, and what bias 1 means.

GF6 has 6 bits: 1 sign, 2 exponent, 3 mantissa. Two exponent bits give codes 0 to 3, and with bias 1 the scale runs from 2^-1 to 2^2. The ratio E / M is 0.667, a distance of 0.049 from 1 / phi. The spec keeps a status line too: the bias is not derived from the closed form, it is chosen per format, and the spec says so.

Try it

Find BIAS and EXP_MAX in gf6.t27 and check them against 2^(E-1) - 1 and 2^E - 1. Then read PHI_BIAS_STATUS and say what it admits.

+
GoldenFloat 8: GF6, six bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf6.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

GF8: one byte

+
+

You will learnThe one-byte GoldenFloat, 1 + 3 + 4, bias 3, and what its largest and smallest values are.

gf8.t27 holds one byte: 1 sign, 3 exponent, 4 mantissa bits, and bias 3, which is 2^(3 - 1) - 1. PHI_DISTANCE is 0.132, the furthest of the seven widths phi_ratio.t27 lists, since 3 / 4 = 0.75 overshoots 1 / phi. Its largest value, by max_value, is (1 + 15/16) * 2^(7 - 3) = 31, and its smallest, by min_positive, is 1/16 * 2^-2 = 1/64. The comments above both functions say 15.5 and 0.0625; the code computes 31 and 1/64. MEMORY_RATIO_VS_FP32 is 0.25: four GF8 values fit where one FP32 does.

Try it

Compute max_value and min_positive of gf8.t27 by hand and compare them with the comments above them. Then decode the code 0b01000000 that the test gf8_phi_distance expects for phi, and say what value it holds.

+
GoldenFloat 9: GF8, one byteThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf8.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · Ten to fourteen bits

GF10, GF12 and GF14, and how the distance from 1 / phi moves as the word grows.

+
+
10

Lesson 10 of 27

GF10: ten bits

+
+

You will learnHow 10 bits split into 1 + 3 + 6, and why its ratio sits 0.118 from 1 / phi.

GF10 has 10 bits: 1 sign, 3 exponent, 6 mantissa, bias 3. The rule gives E = round(9 / phi^2) = 3, and E / M is 0.5, the same distance of 0.118 from 1 / phi as GF4. Rounding to whole bits is what costs it: at small widths there are few splits to choose from.

Try it

Find EM_RATIO and PHI_DIST in gf10.t27. Then compute round(9 / phi^2) yourself and check it against EXP_BITS.

+
GoldenFloat 10: GF10, ten bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf10.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

GF12: twelve bits

+
+

You will learnThe twelve-bit GoldenFloat, 1 + 4 + 7, bias 7, and how a test name can promise more than its assert.

gf12.t27 holds 12 bits: 1 sign, 4 exponent, 7 mantissa bits, and bias 7. Its ratio E / M is 4 / 7 = 0.571, and PHI_DISTANCE is 0.0466. The test that checks it is named gf12_phi_distance_lowest, but it asserts only that the distance is under 0.05, and a comment in the spec calls GF12 the closest of all formats. The family says otherwise: GF14 in the next lesson sits 0.007 from 1 / phi, and GF32 0.0135. Read a test by its assert, not by its name. MEMORY_RATIO_VS_FP32 is 12 / 32 = 0.375.

Try it

Find PHI_DISTANCE and the test gf12_phi_distance_lowest in gf12.t27. Then compare the distance with GF14 and GF32 and say what the test name claims that its assert does not.

+
GoldenFloat 11: GF12, twelve bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf12.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

GF14: fourteen bits

+
+

You will learnHow 14 bits split into 1 + 5 + 8, a ratio 0.007 from 1 / phi.

GF14 has 14 bits: 1 sign, 5 exponent, 8 mantissa, bias 15. Its ratio E / M is 0.625, only 0.007 from 1 / phi, because 5 and 8 are neighbouring Fibonacci numbers, and the ratio of neighbours approaches 1 / phi.

Try it

Find PHI_DIST in gf14.t27 and compare it with GF10. Then name the next pair of Fibonacci numbers after 5 and 8.

+
GoldenFloat 12: GF14, fourteen bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf14.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · GF16 at work

The primary 16-bit format, a two-term dot product in GF-T16, then GF20 and GF24.

+
+
13

Lesson 13 of 27

GF16: the primary format

+
+

You will learnThe 16-bit GoldenFloat the family marks primary: 1 + 6 + 9, bias 31, and its special codes.

GF16 has 16 bits: 1 sign, 6 exponent, 9 mantissa, bias 31. Exponent code 63, all ones, is kept for infinity and NaN, as in IEEE 754. The spec gives every special code a name: 0x0000 and 0x8000 for the two zeros, 0x7E00 and 0xFE00 for the two infinities, 0xFE01 for NaN. A mantissa of 9 bits divides by 512.

Try it

Find SIGN_MASK, EXP_MASK and MANT_MASK in gf16.t27 and check that together they cover all 16 bits. Then find the code of NaN and say which field makes it not an infinity.

+
GoldenFloat 13: GF16, the primary formatThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf16.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Two products, one sum

+
+

You will learnHow a GF-T16 multiply-accumulate computes a1 * b1 + a2 * b2, the kernel of a matrix multiply.

Every layer of a network is a stack of dot products, and a dot product is products added up. gft_dot2.t27 is the smallest one: y = a1 * b1 + a2 * b2 in GF-T16, a 16-bit magnitude of a 7-bit offset and a 9-bit mantissa with bias 40. In that layout 1.0 is code 20480 and 2.0 is code 20992. The spec has two tests: 1 * 1 = 1, and 1 * 1 + 1 * 1 = 2.

Try it

Find the two tests and decode 20480 and 20992 by hand with value = (1 + mant / 512) * 2^(offset - 40). Then find the line in gft_mul that handles the carry when the product passes 2.

+
GoldenFloat 14: two products, one sumThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/gft_dot2.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

GF20 and GF24

+
+

You will learnThe 20- and 24-bit GoldenFloats, 1 + 7 + 12 and 1 + 9 + 14, and the tolerance each spec allows.

gf20.t27 holds 1 sign, 7 exponent and 12 mantissa bits with bias 63; gf24.t27 holds 1 sign, 9 exponent and 14 mantissa bits with bias 255. The lesson opens gf24.t27, whose PHI_DISTANCE is 0.0248, and its test allows anything under 0.03; MEMORY_RATIO_VS_FP32 is 0.75. GF20 writes its distance as 0.03463, under a test bound of 0.04, while 7 / 12 sits 0.03470 from 1 / phi: the stored constant and the arithmetic differ in the fourth decimal. Between them, both widths keep the ratio within 0.035 of 1 / phi.

Try it

Find PHI_DISTANCE and EXP_BIAS in gf24.t27 and check the bias against 2^(9 - 1) - 1. Then compute 7 / 12 against 0.618034 and compare it with the constant gf20.t27 stores.

+
GoldenFloat 15: GF20 and GF24The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf24.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · GF32 to GF64

GF32 beside IEEE single, GF48 with no IEEE twin, GF64 beside IEEE double.

+
+
16

Lesson 16 of 27

GF32: a single

+
+

You will learnThe 32-bit GoldenFloat, 1 + 12 + 19, bias 2047, and the two invariants that compare it with IEEE single.

gf32.t27 holds 32 bits: 1 sign, 12 exponent, 19 mantissa bits, and bias 2047. IEEE single spends 8 bits on the exponent and 23 on the mantissa; the spec keeps two invariants that say so, EXP_BITS > 8 and MANT_BITS < 23, so GF32 trades precision for range at the same width. Its PHI_DISTANCE is 0.0135, under the test bound of 0.015, and MEMORY_RATIO_VS_FP32 is 1. A comment calls GF32 second after GF12; by the distances in this course it is closer than GF12, and GF14 is closer still.

Try it

Find the two invariants of gf32.t27 that compare it with IEEE single. Then check EXP_BIAS against 2^(12 - 1) - 1 and compute 12 / 19.

+
GoldenFloat 16: GF32, a singleThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf32.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

GF48: forty-eight bits

+
+

You will learnHow the rule splits 48 bits into 1 + 18 + 29, a width IEEE 754 does not have.

GF48 has 48 bits: 1 sign, 18 exponent, 29 mantissa, bias 131071. IEEE 754 has no 48-bit format; the rule makes one the same way it makes all the others. Its ratio E / M is 0.621, 0.003 from 1 / phi.

Try it

Find BIAS and EXP_MAX in gf48.t27 and check them against 2^17 - 1 and 2^18 - 1. Then find the three shift constants and say which field each one places.

+
GoldenFloat 17: GF48, forty-eight bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf48.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

GF64: a double

+
+

You will learnThe 64-bit GoldenFloat, 1 + 24 + 39, beside IEEE double, and how its encoder clamps the exponent.

GF64 has 64 bits: 1 sign, 24 exponent, 39 mantissa, bias 8388607. IEEE double spends 11 bits on the exponent and 52 on the mantissa; GF64 trades mantissa for a far wider range. Its spec has an encoder and a decoder: the mantissa divides by 2^39, and the exponent is clamped between 0 and 2^24 - 1.

Try it

Find EXP_BIAS, EXP_MAX and MANT_DIV in gf64.t27. Then open encode and find where the exponent is clamped.

+
GoldenFloat 18: GF64, a doubleThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf64.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · GF96 to GF256

GF96, GF128 and GF256, where the specs hold the layout with invariants.

+
+
19

Lesson 19 of 27

GF96: ninety-six bits

+
+

You will learnWhy the spec of a 96-bit float writes its bias as an expression, not a number.

GF96 has 96 bits: 1 sign, 36 exponent, 59 mantissa. Its bias, 2^35 - 1, no longer fits the 64-bit integer types the spec uses for small formats, so the spec writes it as the text 2^(36-1) - 1 and checks the layout with invariants instead. The ratio E / M is 0.610.

Try it

Find BIAS_EXPR and EXP_MAX_EXPR in gf96.t27 and compare them with BIAS in gf48.t27. Then read the invariants and say what each one checks.

+
GoldenFloat 19: GF96, ninety-six bitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf96.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

GF128: a quad

+
+

You will learnThe 128-bit GoldenFloat, 1 + 49 + 78, and the four invariants that hold its layout.

GF128 has 128 bits: 1 sign, 49 exponent, 78 mantissa. IEEE quad spends 15 bits on the exponent. The spec holds the layout with four invariants: the fields partition the word, the mantissa and the exponent follow the closed form, and the shifts follow the layout.

Try it

Read the four invariants of gf128.t27 and check SIGN_SHIFT and EXP_SHIFT against the field widths by hand.

+
GoldenFloat 20: GF128, a quadThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf128.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

GF256: two hundred fifty-six bits

+
+

You will learnHow the rule splits 256 bits into 1 + 97 + 158.

GF256 has 256 bits: 1 sign, 97 exponent, 158 mantissa. The family spec has a test for these counts too. At this width rounding costs little, and the ratio E / M is 0.614, 0.004 from 1 / phi.

Try it

Find EM_RATIO and PHI_DIST in gf256.t27. Then in goldenfloat_family.t27 find the test that checks the GF256 bit counts, and check that both specs agree.

+
GoldenFloat 21: GF256The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf256.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · The widest rungs, then trits

GF512 and GF1024, the two widest rungs, then GF-T8, where the exponent moves to trits.

+
+
22

Lesson 22 of 27

GF512: five hundred twelve bits

+
+

You will learnHow the rule splits 512 bits into 1 + 195 + 316, a ratio within 0.001 of 1 / phi.

GF512 has 512 bits: 1 sign, 195 exponent, 316 mantissa. Its ratio E / M is 0.617, under 0.001 from 1 / phi. The wider the word, the closer whole bits can come to the target, which is the trend the family table shows.

Try it

Find PHI_DIST in gf512.t27 and compare it with GF14 and GF48. Then check SIGN_SHIFT and EXP_SHIFT by hand.

+
GoldenFloat 22: GF512The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf512.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

GF1024: one kilobit

+
+

You will learnThe widest rung of the family, 1 + 391 + 632, and the test that names it.

GF1024 has 1024 bits: 1 sign, 391 exponent, 632 mantissa. Its ratio E / M is 0.6187, a distance of 0.0006 from 1 / phi, and the family spec has a test that names GF1024 as the format with the smallest phi distance. It is a rung of the family on paper; no hardware in this course computes in it.

Try it

Find PHI_DIST in gf1024.t27. Then in goldenfloat_family.t27 find the test about GF1024 and the function it calls.

+
GoldenFloat 23: GF1024, one kilobitThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gf1024.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

GF-T8: an exponent in trits

+
+

You will learnHow GF-T keeps the phi split but stores the exponent in balanced trits: 1 + 3 trits + 4 bits.

GF-T is GoldenFloat with a ternary exponent. GF-T8 has 1 sign, 3 exponent trits and 4 mantissa bits. Three trits give 27 exponent values, offset 13 makes them balanced around zero, and offset 26 is kept as the one non-finite value. The spec tests the split as E / M in thousandths: 3000 / 4 = 750.

Try it

Run the two tests of gft8.t27. Then find exp_values and is_finite and say which offset is not finite.

+
GoldenFloat 24: GF-T8, an exponent in tritsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gft8.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · More trits, then the decode

GF-T16 and GF-T32, then why fixed fields decode in parallel and a posit does not.

+
+
25

Lesson 25 of 27

GF-T16: six trits

+
+

You will learnHow GF-T16 spends 6 exponent trits and 9 mantissa bits, and how many exponent values that gives.

GF-T16 has 1 sign, 6 exponent trits and 9 mantissa bits. Six trits give 3^6 = 729 exponent values; offset 364 balances them and offset 728 is not finite. The split in thousandths is 6000 / 9 = 666. Its mantissa has the same 9 bits as GF16, so the two differ only in how they store the exponent.

Try it

Run the two tests of gft16.t27. Then compare MANT_BITS with GF16 and work out the range 729 exponent values cover around zero.

+
GoldenFloat 25: GF-T16, six tritsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gft16.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

GF-T32: twelve trits

+
+

You will learnHow GF-T32 spends 12 exponent trits and 19 mantissa bits.

GF-T32 has 1 sign, 12 exponent trits and 19 mantissa bits. Twelve trits give 3^12 = 531441 exponent values; offset 265720 balances them and offset 531440 is not finite. The split in thousandths is 12000 / 19 = 631. The 19 mantissa bits match GF32 in the family table.

Try it

Run the two tests of gft32.t27 and check 3^12 by hand. Then compare its mantissa with the GF32 row of the family spec.

+
GoldenFloat 26: GF-T32, twelve tritsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/gft32.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

Decode in one step

+
+

You will learnWhy a fixed-field format decodes its fields in parallel and a posit cannot, as the spec counts the steps.

A posit packs a regime of variable length before its exponent, so a decoder must find where the regime ends before it can read anything else. GF16 and IEEE FP16 keep every field at a fixed position, so all fields decode at once. gf_competitive.t27 counts the steps: 3 for FP16, 6 for POSIT16, 3 for GF16, and marks which can run in parallel. These are counts written into the spec, not a timing measured on hardware.

Try it

Find decode_complexity and the three entries it returns. Then find the invariant that compares the posit with GF16, and say what a timing on hardware would add.

+
GoldenFloat 27: decode in one stepThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/math/gf_competitive.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · The rule and its numbers
    1. 01 A float cut by phi
    2. 02 Phi as a ratio
    3. 03 Lucas numbers stay whole
  2. 02 · Why phi, why three
    1. 04 Why the split is phi
    2. 05 Why base three
    3. 06 Phi in sixteen bits
  3. 03 · The small rungs: GF4 to GF8
    1. 07 GF4: four bits
    2. 08 GF6: six bits
    3. 09 GF8: one byte
  4. 04 · Ten to fourteen bits
    1. 10 GF10: ten bits
    2. 11 GF12: twelve bits
    3. 12 GF14: fourteen bits
  5. 05 · GF16 at work
    1. 13 GF16: the primary format
    2. 14 Two products, one sum
    3. 15 GF20 and GF24
  6. 06 · GF32 to GF64
    1. 16 GF32: a single
    2. 17 GF48: forty-eight bits
    3. 18 GF64: a double
  7. 07 · GF96 to GF256
    1. 19 GF96: ninety-six bits
    2. 20 GF128: a quad
    3. 21 GF256: two hundred fifty-six bits
  8. 08 · The widest rungs, then trits
    1. 22 GF512: five hundred twelve bits
    2. 23 GF1024: one kilobit
    3. 24 GF-T8: an exponent in trits
  9. 09 · More trits, then the decode
    1. 25 GF-T16: six trits
    2. 26 GF-T32: twelve trits
    3. 27 Decode in one step
+ + + + + diff --git a/apps/website/public/learn/goldenfloat/index.html b/apps/website/public/learn/goldenfloat/index.html index 520744b9ee..7939af8f16 100644 --- a/apps/website/public/learn/goldenfloat/index.html +++ b/apps/website/public/learn/goldenfloat/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

GoldenFloat with t27: one rule, seventeen float widths

It follows the AI numbers course. Every lesson opens a table drawn from one spec, next to that spec running in your browser; where a spec's comment and its code disagree, the lesson says which is which.

Course 3, 9 modules of 3 lessons, one widget and one t27 spec each: the GoldenFloat family, where one rule built on phi splits every width from 4 to 1024 bits into sign, exponent and mantissa, then the same split with an exponent in trits.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/gradient-descent/index.html b/apps/website/public/learn/gradient-descent/index.html index e5d49c2786..09054c9b27 100644 --- a/apps/website/public/learn/gradient-descent/index.html +++ b/apps/website/public/learn/gradient-descent/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Gradient descent

You will learn

How gradient descent walks down a loss, what momentum adds, and why too large a rate never settles.

Training is walking downhill on the loss. Gradient descent moves a weight by -lr times its gradient each step; in the spec the loss is (x - 3)^2 from x = 0, and lr 0.1 reaches 2.99996 in 50 steps. Momentum adds a share of the last move, which speeds up a long slope and overshoots a sharp bottom: at 0.9 the weight shoots past 3 to about 5.13 and rings down to 3.09 after 50 steps. Nesterov takes the gradient one step ahead and swings less, to about 4.25. Too large a rate never settles: at lr 1 the weight bounces between 0 and 6 for good. The spec sgd.t27 computes every step.

Try it

Find the largest learning rate that still settles without momentum; then add momentum 0.9 and count the swings.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Gradient descent: how a network walks downhill
Gradient descent: how a network walks downhill ↗

Set the learning rate and momentum and watch a weight walk from 0 to the bottom of (x - 3)^2. Plain steps creep, momentum overshoots and rings, and a rate of 1 bounces forever.

specs/ml/optimizer/sgd.t27

// SPDX-License-Identifier: Apache-2.0
@@ -232,6 +264,7 @@ 

Gradient descent

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/gray-code/index.html b/apps/website/public/learn/gray-code/index.html index ca7275406c..51901803a3 100644 --- a/apps/website/public/learn/gray-code/index.html +++ b/apps/website/public/learn/gray-code/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Gray code

You will learn

Why Gray code changes one bit at a time, and what a test suite that never reads pointers cannot see.

Gray code changes exactly one bit per step, so a sample taken mid-change reads one of two adjacent codes -- off by one, never garbage. A FIFO whose read and write pointers count in Gray can be sampled across domains safely, and the flags derived from them hold. The recording plants a mutation that Gray would have caught red-handed if the tests had looked: (state.head_ptr + 1) becomes + 3, and every test still passes, because the suite asserts fill and flags, never pointer values. A test suite defends what it reads; the encoding is defended by the next lesson's rule, not by these tests. The recording restores the spec and prints its sha256.

Try it

In the recording, find the sed line and confirm that no test failed; then in the spec frame find the fill and flag assertions and point at the hole the mutation slipped through.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on fifo.t27 -- a pointer mutation the tests cannot see
t27c on fifo.t27 -- a pointer mutation the tests cannot see ↗

head_ptr + 1 to + 3 in one sed: every test still passes, because the suite asserts fill counts and flags, never pointer values -- the exact hole a torn multi-bit pointer would slip through; git restores the spec.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Gray code

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/growth-through-the-stages/index.html b/apps/website/public/learn/growth-through-the-stages/index.html index 6412971106..6ddc17edab 100644 --- a/apps/website/public/learn/growth-through-the-stages/index.html +++ b/apps/website/public/learn/growth-through-the-stages/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Growth through the stages

You will learn

How many bits the words of an FFT grow, and what halving every stage holds back and what it loses.

Every radix-2 stage can double a value, so an unscaled FFT grows up to log2 N bits, and the conservative width of the AMD FFT core is B + log2 N + 1. A full-scale DC input shows it plainly: 12 bits in, 16 bits out of a 16-point FFT, against the 17 of the rule. Halving every stage holds the word at 12 bits, but a spread signal loses a bit of precision at every stage. The spec signals.t27 runs the integer FFT the widget measures.

Try it

Run DC unscaled and halved; then run the noise input both ways and compare the largest output.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

FFT word growth: how many bits each stage adds
FFT word growth: how many bits each stage adds ↗

Pick a size, an input width and an input, with or without halving every stage. Watch the bits each stage needs grow, and what scaling holds back and what it costs.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Growth through the stages

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/half-adder/index.html b/apps/website/public/learn/half-adder/index.html index d15c9b115f..18f6e3fafc 100644 --- a/apps/website/public/learn/half-adder/index.html +++ b/apps/website/public/learn/half-adder/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The half adder

You will learn

Two trits in, a sum trit and a carry trit out, for all nine cases.

A half adder is the sum and carry tables wired side by side. The spec computes both from trit_at() of a + b: place 0 is the sum, place 1 the carry. Of the nine input pairs only +1 + +1 and -1 + -1 carry; every other pair fits in one trit. Binary's half adder carries on one case of four, ternary's on two of nine.

Try it

Step through all nine cases in the strip and count how many carry; compare with the four cases of a binary half adder.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The half adder: two trits in, a sum and a carry out
The half adder: two trits in, a sum and a carry out ↗

Pick two trits. The half adder writes their sum as a sum trit plus three times a carry trit; all nine cases below.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

The half adder

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/handshakes-and-pulses/index.html b/apps/website/public/learn/handshakes-and-pulses/index.html index c518d0a9e9..c0215673b8 100644 --- a/apps/website/public/learn/handshakes-and-pulses/index.html +++ b/apps/website/public/learn/handshakes-and-pulses/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Handshakes and pulses

You will learn

How a handshake moves a pulse between worlds, and what an edge-driven report and a toggle synchronizer share.

A pulse is the hardest thing to move: one clock wide here is not one clock wide there. The handshake turns it into a level: the sending side raises a request, the receiving side samples it, raises an acknowledge, and the request drops -- four edges, and the pulse became a conversation. The widget is a report that works the same way: 25 live checks, printing only rows that are NEW red or CLEARED since the last look -- the far side sees the change, not the level, exactly what a toggle synchronizer arranges in hardware. The spec frame opens clock_domain.t27, whose handshake strategy is this conversation as one enum value.

Try it

In the widget, find how many checks the report runs and what it prints when nothing changed; then in the spec frame find the handshake strategy and count the edges its conversation takes.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri game-tick: one anomaly scan, only what changed
tri game-tick: one anomaly scan, only what changed ↗

25 live checks on t27.ai and its publisher; prints only NEW red or CLEARED rows. This run: 0 red of 25.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

Handshakes and pulses

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/hello-t27/index.html b/apps/website/public/learn/hello-t27/index.html index dc428ed9ea..b6c857aaef 100644 --- a/apps/website/public/learn/hello-t27/index.html +++ b/apps/website/public/learn/hello-t27/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Hello, t27

You will learn

What a t27 spec looks like, and what the compiler does with it in your browser.

A t27 program is a spec: a module with typed constants, functions and tests. Prose lines start with a semicolon at the start of a line. The player below runs the real t27 compiler, built to WebAssembly, inside your browser: it reads hello_world.t27, runs its tests and writes code for seven backends. Nothing is installed and nothing is sent anywhere. Open the tutorial spec under the widget and read it next to the output.

Try it

Run the tests in the player, then switch the backend and find the same function in two languages.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

hello_world.t27, compiled inside the post
hello_world.t27, compiled inside the post ↗

The t27 compiler, as WebAssembly, running on one spec in your browser: lexer to seven backends, the spec's own tests, the emitted code, its Verilog read for synthesis, and a terminal.

specs/tutorial/02_functions.t27

// SPDX-License-Identifier: Apache-2.0
@@ -151,6 +183,7 @@ 

Hello, t27

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/how-much-fits/index.html b/apps/website/public/learn/how-much-fits/index.html index 043c22d03f..f82ebc77e4 100644 --- a/apps/website/public/learn/how-much-fits/index.html +++ b/apps/website/public/learn/how-much-fits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

How much fits on the chip

You will learn

How to read a resource count and find which resource runs out first.

A synthesis report says how many LUTs, flip-flops, DSPs and block RAMs your design takes. The question that matters is which of them runs out first. A design can use few LUTs and still not fit because it needs more DSPs than the chip has. Type a LUT count, or pick one of our real designs, and see how many copies fit on an XC7A200T.

Try it

Pick a real design, then raise the DSP count until something other than LUTs runs out first. In the spec frame, fits_board checks four resources in turn: which one comes last, and how many DSP48 blocks does xc7a100t_resources list?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Fits on a 200T: how many copies of your design an XC7A200T holds
Fits on a 200T: how many copies of your design an XC7A200T holds ↗

Type your LUT count (and FF, DSP, BRAM) and see how many copies fit on an XC7A200T, one grid cell per copy, and which resource runs out first. Totals from nextpnr-xilinx.

specs/fpga/stdlib.t27

// SPDX-License-Identifier: Apache-2.0
@@ -439,6 +471,7 @@ 

How much fits on the chip

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/if-and-else/index.html b/apps/website/public/learn/if-and-else/index.html index 4f329514b6..844f0a1c60 100644 --- a/apps/website/public/learn/if-and-else/index.html +++ b/apps/website/public/learn/if-and-else/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Choices: if, else and switch

You will learn

The forms of if the compiler accepts, the if expression, and switch with else.

if (a > b) { ... } else { ... } runs one of two blocks. The parentheses are optional: if a > b { ... } also compiles. if can be an expression too: return if (a > b) a else b; gives the larger one. switch (m) { 0 => 10, else => 20 } picks a value by matching m, and else covers every other case.

Try it

Add a case 1 => 15 to the switch in the player and check the verdict.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 14: the shapes of a choice
t27 basics 14: the shapes of a choice ↗

Every form of if and switch the t27 compiler accepts, each checked with the real compiler. Lesson 14 of the t27 basics course.

specs/basics/14_if_and_else.t27

// SPDX-License-Identifier: Apache-2.0
@@ -98,6 +130,7 @@ 

Choices: if, else and switch

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/index.html b/apps/website/public/learn/index.html index 016a593112..b36c20f276 100644 --- a/apps/website/public/learn/index.html +++ b/apps/website/public/learn/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

t27 basics: the language in 27 lessons

Before the FPGA course: what a t27 spec is, how the compiler reads it, and what it gives back. Every lesson opens one table or diagram drawn from its own spec and one spec you can run in your browser.

Course 0, 27 lessons, one infographic and one t27 spec each: a module, constants and types, functions and tests, then the compiler's stages and the 7 languages it writes. It comes before the FPGA course.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

  1. t27 basics: the language in 27 lessons
  2. From zero to a chip: FPGA programming with t27
  3. AI numbers with t27: from number formats to a ternary network
  4. GoldenFloat with t27: one rule, seventeen float widths
  5. Verifying hardware with t27: testbenches, waveforms, formal, mutation
  6. Clocking, resets and clock-domain crossings with t27
  7. Buses and peripherals with t27: UART, SPI, APB, AXI4, Ethernet
  8. The ternary machine: from a trit to a running program
  9. Arithmetic and DSP on the FPGA: from the carry chain to a filter
  10. Neural networks in t27: from one neuron to a transformer block
  11. The Queen and the hive: how the t27 project builds itself

All lessons

+
diff --git a/apps/website/public/learn/induction/index.html b/apps/website/public/learn/induction/index.html index d391c554ab..c8ee3a290f 100644 --- a/apps/website/public/learn/induction/index.html +++ b/apps/website/public/learn/induction/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Induction

You will learn

Why bounded is not a proof, and how induction closes the gap -- or reports it cannot.

Bounded means bounded: k cycles checked is all k proves. To close the gap you need induction -- assume the invariant held up to cycle k, show it holds at k+1 -- and induction is honest in a way BMC is not: it can fail, and a failed induction is a finding, not an embarrassment. The widget is what an un-discharged obligation looks like when nobody looks: 12 Lean files, 15,553 lines and 4 sorry, reached by no build root -- nothing compiles them, so the proofs they contain have never been checked. An obligation no root reaches is not discharged; it is parked.

Try it

Find the 4 sorry in the Lean sweep and say what a build root that reached them would change; then name one invariant of uart_tb you would try to induct.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri lean: proofs that nothing compiles
tri lean: proofs that nothing compiles ↗

12 Lean files, 15,553 lines and 4 sorry, are reached by no build root: nothing compiles them.

specs/fpga/testbench/formal_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -205,6 +237,7 @@ 

Induction

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/inherited-red/index.html b/apps/website/public/learn/inherited-red/index.html index cce913432e..51233bdfa4 100644 --- a/apps/website/public/learn/inherited-red/index.html +++ b/apps/website/public/learn/inherited-red/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Inherited red

You will learn

When a red check on a pull request is inherited from master, and why a cancelled run says nothing.

A bee may approve a PR with a red check when that check is red on master too. On 2026-10-06 a PR merged red because master's run of that check was cancelled and was read as red. Now the merger reads master itself, newest run first: run_says counts only a completed failure or success, look_back passes over everything else and over runs older than the merge base, and discount_holds needs the bee's word and MASTER RED.

Try it

Make every run cancelled; then move the failure before the merge base and look at the gate.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Inherited red: what master's runs say about a red check
Inherited red: what master's runs say about a red check ↗

The bee says a red check is red on master too. The merger reads master itself, newest run first: a cancelled run is looked past, and only a failure at or after the merge base discounts.

specs/queen/merger_gate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

Inherited red

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/invariants/index.html b/apps/website/public/learn/invariants/index.html index 80aa1f2f88..0e88d4982f 100644 --- a/apps/website/public/learn/invariants/index.html +++ b/apps/website/public/learn/invariants/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Invariants and benches

You will learn

How invariant and bench blocks are written and who evaluates them.

invariant name followed by an assert states a rule of the spec that must hold for every value, not one example. bench name marks a block to time. Both compile. The test runner on this site evaluates test blocks only: it skips invariants and benches, so a false invariant passes here silently. The lesson spec repeats its invariant as a test for that reason.

Try it

Make the invariant false in the player and check that nothing on this site complains, then make the test false.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 20: test, invariant and bench
t27 basics 20: test, invariant and bench ↗

The three kinds of checking block in t27 and which ones the site test runner evaluates. Lesson 20 of the t27 basics course.

specs/basics/20_invariants.t27

// SPDX-License-Identifier: Apache-2.0
@@ -82,6 +114,7 @@ 

Invariants and benches

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/io-timing/index.html b/apps/website/public/learn/io-timing/index.html index 32b76c96bb..9ba2492be6 100644 --- a/apps/website/public/learn/io-timing/index.html +++ b/apps/website/public/learn/io-timing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

IO timing

You will learn

How IO timing is stated against a clock another chip drives, and what margins read from an SDF look like.

A pin's timing is stated against a clock another chip drives: set_input_delay and set_output_delay, negative before the edge, positive after. The widget shows what such margins look like when they are read instead of assumed: two recorded model runs over the routed E3 design for the AX7203 board (XC7A200T in an FBG484 package), printed -- smallest TX hold 3445 ps on eth_txd[1], smallest RX mid-nibble margin 10900 ps on rxctl_n, both PASS -- a model over nextpnr's own SDF of the routed design, not a board measurement, and it says so. The spec frame opens emitter_xdc.t27 again, the emitter these lines would go into.

Try it

In the widget, find the smallest TX hold and the pin it was measured on; then in the spec frame find where the emitter would put the input and output delays.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-txhold · RGMII margins from nextpnr's own SDF
tri fpga-txhold · RGMII margins from nextpnr's own SDF ↗

Two recorded model runs (2026-09-27 and 09-28), printed: smallest TX hold 3445 ps on eth_txd[1], smallest RX mid-nibble margin 10900 ps on rxctl_n, both PASS. A model over the routed design's SDF, not a board measurement.

specs/pins/emitter_xdc.t27

// SPDX-License-Identifier: Apache-2.0
@@ -362,6 +394,7 @@ 

IO timing

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/jtag-asks-the-chip/index.html b/apps/website/public/learn/jtag-asks-the-chip/index.html index 2f2dfa1eda..917b5df746 100644 --- a/apps/website/public/learn/jtag-asks-the-chip/index.html +++ b/apps/website/public/learn/jtag-asks-the-chip/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

JTAG asks the chip

You will learn

How a cable finds the chip on a board and reads its IDCODE.

JTAG is the cable protocol for talking to the chip on a board. Before programming, the tool shifts out the IDCODE of every device on the chain. This recording decodes the codes our bench answers with, and shows what an even code means: no IDCODE at all. Compare it with the decoder from lesson 2.

Try it

Find which IDCODE belongs to an XC7A200T and which to an XC7A100T. In the spec frame, HELP_LINE says how tri fpga-jtag reads a chain with no answer: what does it blame for all ones, and what for all zeros?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-jtag · which chip answered the cable
tri fpga-jtag · which chip answered the cable ↗

IDCODEs decoded offline: 0x03636093 is an XC7A200T, 0x13631093 an XC7A100T, and an even code is no IDCODE at all (BYPASS or a broken shift). Self-test: 17 of 17 ok.

specs/tools/trios/tri/fpga-jtag.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

JTAG asks the chip

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/kill-the-mutant/index.html b/apps/website/public/learn/kill-the-mutant/index.html index 54c9734a25..bf7ac68610 100644 --- a/apps/website/public/learn/kill-the-mutant/index.html +++ b/apps/website/public/learn/kill-the-mutant/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Kill the mutant

You will learn

How mutation testing plants a bug on purpose and asks the tests to notice.

Mutation testing inverts the whole game: instead of asking whether the tests pass, break the design on purpose and ask whether the tests notice. The widget is the tool doing it to a bitstream path -- plant a bug, watch the tests catch it -- and the lesson's spec is the command that owns the planting. A test suite that passes everything and catches no mutant is a suite that cannot fail, and a suite that cannot fail is not protecting anything.

Try it

Plant a bug with the mutate tool and watch which test catches it; then read the spec and find where the planted fault is named.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri x7-mutate · plant a bug, the tests must catch it
tri x7-mutate · plant a bug, the tests must catch it ↗

Five planted bugs in packets.t27 (CRC polynomial bit, CRC address width, LFRM no-ops, COR0 bit 0, type-2 word count). Each mutant is rebuilt and re-swept; every one is CAUGHT by its tests and by the sweeps. mutate: all 5 caught.

specs/tools/trios/tri/x7-mutate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Kill the mutant

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/kleene-logic/index.html b/apps/website/public/learn/kleene-logic/index.html index d5701fbdfd..9ab59fd6ec 100644 --- a/apps/website/public/learn/kleene-logic/index.html +++ b/apps/website/public/learn/kleene-logic/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Three-valued logic

You will learn

How NOT, MIN and MAX extend Boolean logic with an unknown value.

Let -1 be false, +1 true and 0 unknown. AND becomes the minimum, OR the maximum and NOT a flip: Kleene's strong logic. On the four corners of each 3 x 3 table, where no input is unknown, it is exactly Boolean logic; the middle row and column say what a circuit knows when an input does not. The lesson spec writes them as t_not(), t_min() and t_max(), and its tests check the Boolean corners.

Try it

Find the cells of MIN where an unknown input does not change the answer, and the same cells of MAX.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Three-valued logic: NOT, MIN and MAX
Three-valued logic: NOT, MIN and MAX ↗

False, unknown, true as -1, 0, +1. AND is the minimum, OR the maximum, NOT a flip; on -1 and +1 alone they are Boolean logic.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Three-valued logic

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/lamb-and-large-batches/index.html b/apps/website/public/learn/lamb-and-large-batches/index.html index 8067f34f37..15f2e74e25 100644 --- a/apps/website/public/learn/lamb-and-large-batches/index.html +++ b/apps/website/public/learn/lamb-and-large-batches/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

LAMB and large batches

You will learn

How LAMB scales each layer's step by its own weight norm, so one learning rate suits layers of every size.

Training with very large batches needs a large learning rate, and one rate can be too large for a small layer and too small for a big one. LAMB takes an Adam-style update for each layer and rescales it by the trust ratio, the layer's weight norm, capped at 10, over the update's norm, so every layer moves by the same fraction of itself. In the spec, the weights (1, 2) times a scale take a step whose norm is 0.001 times theirs: 0.00447 at scale 2, and once the weight norm passes 10, near scale 4.47, the step stays at 0.01. The spec lamb.t27 computes the update for one layer and for two at once.

Try it

Read the step at scales 1 and 2 and compare; then drag past the bend and explain why the line goes flat.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

LAMB: one learning rate for layers of every size
LAMB: one learning rate for layers of every size ↗

Scale a layer's weights and watch its LAMB step: it grows with the weight norm, so every layer moves by the same fraction of itself, until the norm passes 10 and the step stops growing.

specs/ml/optimizer/lamb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -314,6 +346,7 @@ 

LAMB and large batches

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/latency/index.html b/apps/website/public/learn/latency/index.html index 80ff120158..fd3153f13d 100644 --- a/apps/website/public/learn/latency/index.html +++ b/apps/website/public/learn/latency/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Latency

You will learn

What latency a memory answers in, and what the memory bench checks of reads and writes.

Every answer costs cycles, and the spec's MemLatency enum carries the kinds a wait state must cover. The bench checks the behaviour: test_reset_clears, test_write_read_single, test_write_read_multiple, test_overwrite, test_all_zero_bits, nine tests. The recording lowers the memory testbench spec to Verilog.

Try it

In the recording, find the bench tests; then in the spec frame find the MemLatency kinds and say what a wait state must cover.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on memory_tb.t27 -- the testbench as RTL
t27c gen-verilog on memory_tb.t27 -- the testbench as RTL ↗

The memory testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/memory_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -236,6 +268,7 @@ 

Latency

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/learning-xor/index.html b/apps/website/public/learn/learning-xor/index.html index 6ae9db9253..60e84e7421 100644 --- a/apps/website/public/learn/learning-xor/index.html +++ b/apps/website/public/learn/learning-xor/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Learning XOR

You will learn

Why one neuron cannot learn XOR, and how a hidden layer trained by backpropagation does.

XOR is 1 when exactly one of two inputs is 1. No straight line separates the cases that give 1 from those that give 0, so a single neuron cannot learn it. A hidden layer bends the space: the spec trains a 2-8-1 network of ReLUs by backpropagation, lr 0.05, from fixed initial weights. Its loss falls from 0.8896 in epoch 1 to 1.8e-13 after 2000 epochs, and its four answers come out within 4e-7 of 0, 1, 1 and 0. The widget runs that training in your browser, from scratch for every point of the curve. The spec mlp.t27 holds the network and the test that it learns.

Try it

Drag the epochs back to 100 and read the four answers; then find the epoch where the curve stops falling.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

XOR: a network learns what one neuron cannot
XOR: a network learns what one neuron cannot ↗

A 2-8-1 network trained by backpropagation in your browser: drag the epochs from 0 to 2000 and watch its four answers move to 0, 1, 1, 0 while the loss falls from 0.89 by twelve orders.

specs/ml/pathway/mlp.t27

// SPDX-License-Identifier: Apache-2.0
@@ -392,6 +424,7 @@ 

Learning XOR

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/line-and-toggle/index.html b/apps/website/public/learn/line-and-toggle/index.html index ea3b88ad2e..21c41870e2 100644 --- a/apps/website/public/learn/line-and-toggle/index.html +++ b/apps/website/public/learn/line-and-toggle/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Line and toggle

You will learn

How line and toggle coverage count what a run touched, signal bit by signal bit.

Line coverage asks: did anything execute this line? Toggle coverage asks a sharper question per bit: did this signal ever go 0-to-1, and ever 1-to-0? A stuck signal can sit under 100 % line coverage forever. The lesson's spec is coverage.t27 -- points with hit counts, per-kind percentages, and illegal arcs that must stay at zero -- with 26 tests and 4 invariants of its own. The widget bars a real design's resources; coverage bars are the same picture drawn over what a run touched.

Try it

Count the points in coverage.t27's fsm_report test and check the percentage by hand; then find one signal in the resource widget a toggle count would flag.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Resource bars: LUT, FF, BRAM and DSP used on the XC7A200T
Resource bars: LUT, FF, BRAM and DSP used on the XC7A200T ↗

A real nextpnr-xilinx run counted against the XC7A200T's own totals, read from the chipdb and prjxray-db. Drop your routed JSON and it counts yours.

specs/fpga/coverage.t27

// SPDX-License-Identifier: Apache-2.0
@@ -574,6 +606,7 @@ 

Line and toggle

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/lite-or-full/index.html b/apps/website/public/learn/lite-or-full/index.html index 022a2f06e1..cb63e11a87 100644 --- a/apps/website/public/learn/lite-or-full/index.html +++ b/apps/website/public/learn/lite-or-full/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Lite or full

You will learn

What AXI4 Lite keeps and drops, and what validation demands of a bus.

Lite is the same handshake with the burst machinery lifted out: no LEN, no size ladder, one transfer at a time. The spec's AxiKind enum carries lite and full, and its tests name the difference -- axi4_lite_is_lite, axi4_full_is_full -- and the validation rules: validate_lite_ok, validate_full_ok, validate_empty_name, validate_zero_addr. The recording runs t27c check on the spec: 0 errors, 0 warnings.

Try it

In the recording, find the error and warning counts; then in the spec frame find the AxiKind values and the four validation tests.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c check on axi4.t27 -- the spec compiles
t27c check on axi4.t27 -- the spec compiles ↗

t27c check typechecks the AXI4 spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/axi4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -461,6 +493,7 @@ 

Lite or full

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/local-names/index.html b/apps/website/public/learn/local-names/index.html index e4ac2b0a26..b303decebb 100644 --- a/apps/website/public/learn/local-names/index.html +++ b/apps/website/public/learn/local-names/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Local names: let and var

You will learn

When to use let and when var, and how a var is updated.

let a = w * h; gives a name to a value inside a function body. var i : u8 = 0; declares a name that may change, and i = i + 1; changes it. Use let when the value is computed once, var when a loop updates it. These names live only inside the function; the module level uses const.

Try it

Change let to var in area and check the verdict; then explain why let reads better there.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 13: let, var and const
t27 basics 13: let, var and const ↗

Where let, var and const live in a t27 spec and whether the name may change. Lesson 13 of the t27 basics course.

specs/basics/13_local_names.t27

// SPDX-License-Identifier: Apache-2.0
@@ -92,6 +124,7 @@ 

Local names: let and var

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/logic-depth/index.html b/apps/website/public/learn/logic-depth/index.html index 81bd8f11d2..f07cf69015 100644 --- a/apps/website/public/learn/logic-depth/index.html +++ b/apps/website/public/learn/logic-depth/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Logic depth

You will learn

Why the longest chain of logic sets how fast a design can run.

A signal needs time to pass through each LUT and each wire. The longest chain of logic between two registers sets how fast the clock can tick. yosys can show that chain as a count of cells, before any routing. The staircase draws it for a real GF16 adder, step by step.

Try it

Open the real sample and count how many steps of the path are LUTs. In the spec frame, est_comb_delay charges each LUT 100 ps plus 300 ps of routing: find the test that gets 600 for three LUTs.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

LUT depth: your longest yosys path, drawn as a staircase
LUT depth: your longest yosys path, drawn as a staircase ↗

Paste yosys ltp -noff output: the longest path after LUT mapping, one step per cell, typed when a dump is in the text. A cell count, not nanoseconds. Read in your browser.

specs/fpga/timing.t27

// SPDX-License-Identifier: Apache-2.0
@@ -446,6 +478,7 @@ 

Logic depth

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/long-multiplication/index.html b/apps/website/public/learn/long-multiplication/index.html index 59a56ec07b..9786ea8b4f 100644 --- a/apps/website/public/learn/long-multiplication/index.html +++ b/apps/website/public/learn/long-multiplication/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Long multiplication

You will learn

How n x m becomes rows of copies, zeros and flips.

Each trit of m picks a copy, a zero or a flip of n, shifted one place per row; adding the rows gives the product. 7 x 8: 8 is +0-, so the rows are -7, 0 and 63, which sum to 56. There is no times table to learn, only the three-way switch of the last lesson and an adder. The spec's long_mul() is checked against n x m on 243 pairs.

Try it

Find a pair whose middle row is a copy and whose other rows are zeros; then multiply 13 by 13.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Long multiplication in balanced ternary
Long multiplication in balanced ternary ↗

Each trit of m picks a copy, a zero or a flip of n, shifted one place per row. Add the rows: that is the product.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Long multiplication

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/loops/index.html b/apps/website/public/learn/loops/index.html index 666f6cff2c..b8e3a99c72 100644 --- a/apps/website/public/learn/loops/index.html +++ b/apps/website/public/learn/loops/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Loops: while and for

You will learn

The three loop forms the compiler accepts and how a range is written.

while (i < n) { i = i + 1; } repeats its block while the condition is true, and the block must move toward making it false. for i in 0..n { } walks i from 0 up to n, with n itself left out. The compiler also accepts the Zig form, for (0..4) |i| { }. A loop usually updates a var declared before it.

Try it

Work out by hand what sum_to returns for n = 4, then write it as a constant with a test.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 15: three loop forms
t27 basics 15: three loop forms ↗

while, for in a range and the Zig-style for, each checked with the real t27 compiler, and a range drawn step by step. Lesson 15 of the t27 basics course.

specs/basics/15_loops.t27

// SPDX-License-Identifier: Apache-2.0
@@ -95,6 +127,7 @@ 

Loops: while and for

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/lowering-the-rate/index.html b/apps/website/public/learn/lowering-the-rate/index.html index 35b2688c99..e9dc83dd47 100644 --- a/apps/website/public/learn/lowering-the-rate/index.html +++ b/apps/website/public/learn/lowering-the-rate/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Lowering the rate

You will learn

What keeping every R-th sample does to the spectrum, and which frequencies fold onto the band you keep.

Keep every R-th sample and the rate drops to fs/R, and every frequency near a multiple of the new rate lands near 0. Decimate 400 by 4 and a tone at 95 lands at 5, right inside a band of 10. The widget paints every input frequency that would fold onto the band: that is what the filter before the decimator has to remove, and why that filter can be cheap where nothing folds. The spec signals.t27 computes each fold.

Try it

With R = 4 and a band of 10, find the red zones and put a tone in each; then raise R and watch the zones multiply.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Decimation: lower the rate without folding noise in
Decimation: lower the rate without folding noise in ↗

Pick a decimation factor and a band to keep. See every input frequency that would fold onto that band, and where a tone lands after the rate drops.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Lowering the rate

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/lstm-gates/index.html b/apps/website/public/learn/lstm-gates/index.html index 0641a1b2e3..8362bf5b5d 100644 --- a/apps/website/public/learn/lstm-gates/index.html +++ b/apps/website/public/learn/lstm-gates/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

LSTM gates

You will learn

How the forget, input and output gates of an LSTM decide what the cell keeps, writes and shows.

An LSTM cell keeps a separate memory c and three gates, each a sigmoid between 0 and 1: forget scales the old memory, input lets in new content g, and output decides how much of the memory to show. c' = f c + i g and h' = o tanh(c'). In the spec's fixture every weight is 0, so each gate is the sigmoid of its bias: with the forget gate at 0.9975 and the input gate at 0.0025, a memory of 1 comes out as 0.9975, and the output is 0.7587. Because c passes through with only a multiply by f, its gradient survives many steps too. The spec lstm_single.t27 computes the cell.

Try it

Load Remember and then Forget and compare the new memory; then write with the input gate open.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

LSTM gates: how a cell decides what to keep
LSTM gates: how a cell decides what to keep ↗

Set the biases of the forget, input and output gates and the old memory: the new memory is forget x old + input x candidate, and the output shows tanh of it through the output gate.

specs/ml/recurrent/lstm_single.t27

// SPDX-License-Identifier: Apache-2.0
@@ -393,6 +425,7 @@ 

LSTM gates

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/lucas-numbers-stay-whole/index.html b/apps/website/public/learn/lucas-numbers-stay-whole/index.html index c6cf5ccf62..a1f6c20375 100644 --- a/apps/website/public/learn/lucas-numbers-stay-whole/index.html +++ b/apps/website/public/learn/lucas-numbers-stay-whole/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Lucas numbers stay whole

You will learn

Why phi^(2n) + phi^(-2n) is always a whole number, and where the 3 of phi^2 + 1/phi^2 = 3 comes from.

phi is irrational, yet phi^2 + phi^(-2) is exactly 3. That is no accident: phi^k + (-1/phi)^k is the Lucas number L_k, and Lucas numbers are whole: 2, 1, 3, 4, 7, 11, 18 and on, each the sum of the two before it. The spec computes phi^(2n) + phi^(-2n) in f64 and checks it against L_2n for n from 0 to 6, within a tolerance of 1e-9. The 3 of the project motto is L_2.

Try it

Run the tests and read the ladder from n = 0 to n = 6. Then find the invariant that names TRINITY as L_2, and the tolerance the f64 comparison allows.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 3: Lucas numbers stay whole
GoldenFloat 3: Lucas numbers stay whole ↗

phi^(2n) + phi^(-2n) against L_2n, read from lucas_accumulator.t27. Lesson 3 of the GoldenFloat course.

specs/numeric/lucas_accumulator.t27

// SPDX-License-Identifier: Apache-2.0
@@ -205,6 +237,7 @@ 

Lucas numbers stay whole

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/many-tests/index.html b/apps/website/public/learn/many-tests/index.html index 8017a69212..233c08045b 100644 --- a/apps/website/public/learn/many-tests/index.html +++ b/apps/website/public/learn/many-tests/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Many tests in one spec

You will learn

Why several small tests read better than one long one, and how the report counts them.

A spec may hold any number of test blocks. Each one checks one idea and has a name that says which. The report counts tests and asserts separately: the lesson spec has 3 tests and 5 asserts. When one fails, its name tells you which idea broke, and the other tests still report on their own ideas.

Try it

Make one of the three tests fail and check that the other two still pass.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 11: three tests, one idea each
t27 basics 11: three tests, one idea each ↗

The tests of a t27 spec counted one by one, with the asserts in each, from the lesson spec. Lesson 11 of the t27 basics course.

specs/basics/11_many_tests.t27

// SPDX-License-Identifier: Apache-2.0
@@ -91,6 +123,7 @@ 

Many tests in one spec

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/master-and-servant/index.html b/apps/website/public/learn/master-and-servant/index.html index 601949b68c..8c971fb80e 100644 --- a/apps/website/public/learn/master-and-servant/index.html +++ b/apps/website/public/learn/master-and-servant/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Master and servant

You will learn

What a register bus is, who drives and who answers, and how APB names the roles.

A register bus gives the conversation roles: one master drives addresses, each servant answers when named. APB is that bus at its plainest, and the spec of this lesson is its bridge: ApbBridge, with APB_ADDR_WIDTH 32, APB_DATA_WIDTH 32 and APB_STRB_WIDTH 4. The recording runs t27c check: 0 errors, 0 warnings. The module after next takes its handshake apart phase by phase.

Try it

In the recording, find the error and warning counts; then in the spec frame find the three APB widths and say what the strobe width of 4 covers.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c check on apb_bridge.t27 -- the spec compiles
t27c check on apb_bridge.t27 -- the spec compiles ↗

t27c check typechecks the APB bridge spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/apb_bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -415,6 +447,7 @@ 

Master and servant

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/max-pooling/index.html b/apps/website/public/learn/max-pooling/index.html index 10a63d9853..8a538aa343 100644 --- a/apps/website/public/learn/max-pooling/index.html +++ b/apps/website/public/learn/max-pooling/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Max pooling

You will learn

What max pooling keeps, where it remembers taking it from, and where the gradient goes.

Max pooling keeps the largest value of each window and drops the rest, so the network cares less about exactly where a feature sits. On the spec's 4 x 4 grid, 2 x 2 windows with stride 2 keep 4, 8, 9 and -2, taken from cells 5, 6, 13 and 11. Overlapping 3 x 3 windows with stride 1 keep 8, 8, 9 and 9. In the backward pass each window's whole gradient goes to its maximum: gradients 1, 2, 3 and 4 land on cells 5, 6, 13 and 11, and every other cell gets 0. The spec maxpool2d_layer.t27 computes the outputs, their positions and the gradient.

Try it

Switch to 3 x 3 windows and find the cell two outputs share; then turn on the gradient for 2 x 2 windows.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Max pooling: what a network keeps when it shrinks a picture
Max pooling: what a network keeps when it shrinks a picture ↗

Pick a window size and stride and tap an output: max pooling keeps the largest value of its window and remembers where it was, and the gradient later goes to that one cell.

specs/ml/layers/maxpool2d_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -237,6 +269,7 @@ 

Max pooling

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/mean-squared-error/index.html b/apps/website/public/learn/mean-squared-error/index.html index 635a6783b4..a322a9c174 100644 --- a/apps/website/public/learn/mean-squared-error/index.html +++ b/apps/website/public/learn/mean-squared-error/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Mean squared error

You will learn

How MSE turns every miss into one number, why it chases large errors, and where its gradient points.

A loss turns all the misses of a model into one number to push down. Mean squared error averages the squared misses: predictions 1.5, 2 and 2 against targets 1, 2 and 3 cost (0.25 + 0 + 1) / 3 = 0.4167. Squaring makes a miss of 2 cost 4 times a miss of 1, so MSE chases large errors. Its gradient for each prediction is 2 (p - t) / n, here 0.333, 0 and -0.667: each prediction is pushed back toward its target. As a function of one prediction the loss is a parabola, a bowl with one bottom. The spec mse_loss.t27 computes the loss and the gradient.

Try it

Move prediction 2 onto its target and read the loss; then drag along the bowl and find its bottom.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Mean squared error: how wrong a guess is, as one number
Mean squared error: how wrong a guess is, as one number ↗

Move three predictions against the targets 1, 2 and 3: the loss is the mean of the squared misses, its bowl is a parabola, and each gradient points its prediction back at the target.

specs/ml/loss/mse_loss.t27

// SPDX-License-Identifier: Apache-2.0
@@ -166,6 +198,7 @@ 

Mean squared error

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/memory-maps/index.html b/apps/website/public/learn/memory-maps/index.html index 4c35ec19c9..f74c2cee4c 100644 --- a/apps/website/public/learn/memory-maps/index.html +++ b/apps/website/public/learn/memory-maps/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Memory maps

You will learn

How a memory map is declared, what BRAM and ROM mean as kinds, and what 15 native tests check.

A memory map is who lives at which address: the spec's MemKind enum carries the kinds, and make_bram_has_depth, make_bram_small and make_bram_single are three of its fifteen tests. The recording is a native run: the memory spec through the real t27c, 15 tests pass and 6 invariants are proved comptime -- the one spec of the bus family the native runner takes whole.

Try it

In the recording, count the passing tests and proved invariants; then in the spec frame find the MemKind values and the three make_bram tests.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on memory.t27 -- the memory map, native
t27c on memory.t27 -- the memory map, native ↗

t27c test-report on the memory spec: 15 tests pass natively and 6 invariants are proved comptime -- address decode, wait states and access sizes.

specs/fpga/memory.t27

// SPDX-License-Identifier: Apache-2.0
@@ -422,6 +454,7 @@ 

Memory maps

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/modes-cpol-cpha/index.html b/apps/website/public/learn/modes-cpol-cpha/index.html index 9e2e6f4d9f..171c2f03a9 100644 --- a/apps/website/public/learn/modes-cpol-cpha/index.html +++ b/apps/website/public/learn/modes-cpol-cpha/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Modes: CPOL and CPHA

You will learn

What CPOL and CPHA mean, why there are four modes, and which one the spec configures.

CPOL picks the clock's idle level, CPHA picks which edge samples: four combinations, four modes, and devices that only speak one. The spec configures mode 0 -- SPI_CPOL 0, SPI_CPHA 0 -- and spi_mode_0_configuration is the test that pins it. The recording lowers the SPI spec to synthesizable Verilog.

Try it

In the recording, find the module ports the Verilog gives the SPI master; then in the spec frame find the mode-0 test and name what CPOL and CPHA each pick.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on spi.t27 -- spec to RTL
t27c gen-verilog on spi.t27 -- spec to RTL ↗

The compiler lowers the SPI spec to synthesizable Verilog: the TRINITY banner, the module port list and the datapath as wires.

specs/fpga/spi.t27

// SPDX-License-Identifier: Apache-2.0
@@ -474,6 +506,7 @@ 

Modes: CPOL and CPHA

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/mtbf/index.html b/apps/website/public/learn/mtbf/index.html index f6e2f04c57..90357a8422 100644 --- a/apps/website/public/learn/mtbf/index.html +++ b/apps/website/public/learn/mtbf/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Mean time between failures

You will learn

How MTBF prices a crossing in integer log2 arithmetic, and which constants are assumptions.

MTBF prices a crossing: e^(T/tau) divided by F_clk, F_data and the window W -- the form Xilinx WP323 teaches. mtbf.t27, written for this course, computes it in integer log2 with 10 fractional bits, because the honest answer overflows every integer seconds count. tau 50 ps and W 10 ps are labelled assumptions: the vendors publish flop parameters only partially. At 100 MHz receiving a 10 MHz stream, 1 stage leaves -200 ps of slack and a Q10 log2-MTBF of -19513 -- under two microseconds; 2 stages leave 9800 ps and 275887 -- beyond any clock the universe will run. The recording runs the native t27c: 15 tests pass, 4 invariants comptime.

Try it

In the recording, find the grep that lists the assumptions; then in the spec frame compute what stage_gain_q10() says one more flop buys at 100 MHz.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on mtbf.t27 -- MTBF in integer log2, native
t27c on mtbf.t27 -- MTBF in integer log2, native ↗

t27c 0.4.0 on a laptop (macOS): 15 tests pass natively -- the WP323 form in Q10 log2, one flop negative slack, two flops astronomical, and the grep that shows the assumptions.

specs/fpga/mtbf.t27

// SPDX-License-Identifier: Apache-2.0
@@ -328,6 +360,7 @@ 

Mean time between failures

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/multiply-and-divide/index.html b/apps/website/public/learn/multiply-and-divide/index.html index e12103ecfb..9f6d04a69e 100644 --- a/apps/website/public/learn/multiply-and-divide/index.html +++ b/apps/website/public/learn/multiply-and-divide/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Multiply and divide

You will learn

How the MMCM turns one clock into another by multiply and divide, and which windows the numbers must land in.

The MMCM turns one clock into another: the input is divided by D, multiplied by M into an internal VCO, and the VCO is divided by O for the output. mmcm.t27, written for this course, keeps M in eighths so fractional steps stay integer: M 2.000 to 64.000, D 1 to 106, O 1 to 128, and the VCO must land in its window -- 800 to 1600 MHz here, a teaching assumption the header labels, next to the ranges that come from UG472. From 200 MHz in, M 5, D 1: a 1000 MHz VCO, and O 10 gives 100 MHz out. The recording runs the native t27c: 16 tests pass, 4 invariants comptime.

Try it

In the recording, find the 500 MHz configuration the rejection test names; then in the spec frame find which ranges the header says come from UG472 and which are labelled assumptions.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on mmcm.t27 -- the MMCM model, native
t27c on mmcm.t27 -- the MMCM model, native ↗

t27c 0.4.0 on a laptop (macOS): 16 tests pass natively -- VCO window, M/D/O ranges, fractional multiply in eighths, the 1/56 VCO-period phase step, and the lock window.

specs/fpga/mmcm.t27

// SPDX-License-Identifier: Apache-2.0
@@ -339,6 +371,7 @@ 

Multiply and divide

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/multiply-then-add/index.html b/apps/website/public/learn/multiply-then-add/index.html index 357073c965..aad746145a 100644 --- a/apps/website/public/learn/multiply-then-add/index.html +++ b/apps/website/public/learn/multiply-then-add/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Multiply, then add

You will learn

What a multiply-accumulate does with two signed products, and how the swap from lesson 12 breaks it.

A neuron sums products of weights and inputs, and on_comb in gft_signed_mac.t27 is such a sum with two terms: smul(a1, b1) plus smul(a2, b2). Here smul sets the sign with XOR and has no zero guard. The native t27c runs 4 tests and all pass; one of them, zero_clause, expects 0 x 1 + 0 x 1 to give 512, which is 2^-39, not 0, and its comment calls that the designed behaviour. The browser skips its tests because its runner does not know assert_eq yet. The recording runs t27c test-report, then repeats the bug of lesson 12 with a one-line sed that swaps XOR for OR, and runs t27c test-report again. Exactly one test fails, pp: (-1.0) x (-1.0) now comes out negative, so the sum is 0 instead of 2.0. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the test that expects 512 and the test the planted bug breaks; then in the spec frame change the XOR in smul to OR yourself and see whether the browser catches it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_signed_mac.t27 -- multiply, then add, native
t27c on gft_signed_mac.t27 -- multiply, then add, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; OR in place of the sign XOR makes exactly one test fail, pp; git restores the spec.

specs/ternary/gft_signed_mac.t27

module GftSignedMac;
@@ -237,6 +269,7 @@ 

Multiply, then add

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/negate-twice/index.html b/apps/website/public/learn/negate-twice/index.html index ba0b1b53ab..450b9dd453 100644 --- a/apps/website/public/learn/negate-twice/index.html +++ b/apps/website/public/learn/negate-twice/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Negate twice, get the number back

You will learn

How a test of a property catches a one-character bug that a single example misses.

The browser skipped 24 checks of tnf17.t27; the native t27c runs all 34 tests, all pass, and none is vacuous. Negation flips the sign bit with XOR. The recording swaps XOR for OR, a one-character bug. Negating a positive number still looks right, so the test that negates one still passes. But negating a negative number now leaves it negative, so negating twice no longer gives the number back. Exactly one test fails, negate_is_an_involution, the one that states that property. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find how many passes were vacuous; then go back to the player of the previous lesson, change the XOR to OR yourself, and see whether the browser catches it too.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on tnf17.t27 -- a 17-bit ternary-exponent float, native
t27c on tnf17.t27 -- a 17-bit ternary-exponent float, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 34 tests pass natively; negating with OR instead of XOR fails exactly one test, the involution; git restores the spec.

specs/numeric/tnf17.t27

// SPDX-License-Identifier: Apache-2.0
@@ -434,6 +466,7 @@ 

Negate twice, get the number back

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/neural-networks/all/card.png b/apps/website/public/learn/neural-networks/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..1b156dff313941642a904c4a86633e996e4e8aac GIT binary patch literal 38655 zcmeFYXH-*B*DZ_{v4B!6NI;}Xmkyz+^w1<2rOW%LJI%Zzwl@8XKH1wRIm=Q5!_O}OE1(W%n68j{PXtRVWJk{yWuOoNHI-JUx|3#0r0pp}!h8k$H(%SxJh?riAXc)En}2 zxI$iD-iwPRG;6&*Q;m;($PxUM+LDBN%Y$3POIqqtTn(1C}`j#LEH9edym2KaiUd{?sqYo_H{yU)jKcyo-a=F!y8g%Z)xWK%@VR-J_RiPfpba%b1D%dHL1 zlc}*Bvt;w*3hgp^P4$R%sBS{F9nsbr%@nwtl`UjQ^I%YVe57xdbP$gV@bi!-q*WfT zaC0>*c>K|%A>3InJJk2upRI^A>z|QsChaQqY{l|KkK}HDGBlHYQfxTzMF5dx83s{r zncD06mDMC~??m2;_g)dQm^@Wz;0}{}Rq-UieErz{?=bnZ!N7b1Drdds^yRvJxesc| zh*;XFE#Wd<-2!tQ3qCRp*iHT;tI0XBn_(HYw}e8YHr{$`S=*AEf(pBcHB3DLi^Ljl z$J5Xrf8U$6zILAPHnLObbn9KmY#&O1r_wzhcgTB^ln@IP&I!+)FG{EEcYC<5ovGQg zPtmb0Tbp;4nk+Au@A-DNPzTgob%h2j@jGbaH%%Sy@=qB^1dNgkhFOwbjj(UbWvO6r zbXk@#KkK+SrsTMpcbN|Jb>VNFLQVnS#5cobXz@Mb>dN2WBKNp$=YRRzau;yNVv~g| zXx?=Er7C*BtNbbJO!_Ii!{?KGETaLPg+WU>FJaF*;?fG^CWH3F!-+GSkr8(%Vhct# zryUc=%5v_`>mJu=@5>2o23Ul)?L1%zI#;32b$YfCQ1l>juEDs5Iy@q$_DP_shQ&#n zSc6P}xBrVgWldut2R(mWAreKsei0PxYLpb8F|xc<%KL$kKWAGy@Sx&}+emLLb#;UK z6^iwqq72IpWZ=qdQ6($}zOt}Uc2*V}w5$b6%3;5|%0Akezof}ns<0fG&!zpD?0vMM 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 literal 0 HcmV?d00001 diff --git a/apps/website/public/learn/neural-networks/all/index.html b/apps/website/public/learn/neural-networks/all/index.html new file mode 100644 index 0000000000..20c4e19131 --- /dev/null +++ b/apps/website/public/learn/neural-networks/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Neural networks in t27: from one neuron to a transformer block: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

Neural networks in t27: from one neuron to a transformer block

+

The agents of this project think with neural networks, and here their parts are written as t27 specs with tests, specs the compiler checks. Every widget runs the fn bodies of a specs/ml spec compiled to WebAssembly: move a slider and the spec answers.

+

Course 10, 27 lessons, a live widget and a t27 spec each: activations, softmax and embeddings, pooling and batch norm, losses, SGD, RMSProp and Adam, backpropagation and XOR, recurrent cells, attention, a transformer block and PPO. Every number is computed by a compiled spec.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · One neuron

A neuron sums its inputs and bends the sum: ReLU, the sigmoid and tanh, and where each one stops passing a gradient back.

+
+
01

Lesson 1 of 27

ReLU: keep the positive part

+
+

You will learnWhat ReLU does to a positive and to a negative input, and why a slope of 0 stops a unit from learning.

A neuron adds up its weighted inputs and passes the sum through an activation. ReLU is the plainest one, max(0, x): a positive sum goes through unchanged and a negative one becomes 0. Its slope is 1 or 0, and a slope of 0 is a unit that has stopped learning, because no gradient flows back through it. A leaky slope fixes that: with a slope of 0.1, x = -2 gives -0.2 and passes back a gradient of 0.1. The spec relu_activation.t27 computes both curves the widget draws.

Try it

Put x at -2 and read the slope with and without the leak; then find the slope at x = 1.5.

+
ReLU: what a neuron does with a negative numberThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/activation/relu_activation.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

The sigmoid: a number into a probability

+
+

You will learnHow the sigmoid maps any input to a probability, and why its slope limits deep networks.

The sigmoid 1 / (1 + e^-x) squeezes the whole number line into 0 to 1, which is why it reads as a probability: 2 becomes 0.8808 and -4 becomes 0.018. Its slope is s (1 - s), computed from the output s itself, and it is largest at 0, where it is 0.25; at x = 8 it is 0.000335. A gradient that passes back through a stack of sigmoids is multiplied by at most 0.25 at each one, which is why deep sigmoid networks trained slowly. The spec sigmoid_activation.t27 computes the curve and the slope.

Try it

Find the input where the probability is 0.5; then drag to 6 and read how little slope is left.

+
Sigmoid: turn any number into a probabilityThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/activation/sigmoid_activation.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

tanh and saturation

+
+

You will learnWhy tanh is centred on zero, and where its slope falls so low that a unit stops learning.

tanh is a sigmoid stretched to -1..1 and centred on 0, so a layer of tanh units passes on values that average near zero, and its slope reaches 1 at the centre. It still saturates: at 2.5 the output is 0.9866 and the slope only 0.0266. The red band marks every input where the slope is under 0.1, beyond about 1.8 on either side, and a unit whose inputs live there barely learns. The spec tanh_activation.t27 computes the curve, the slope and its own batch, tanh of 0, 1 and 2: 0, 0.762 and 0.964.

Try it

Drag x until the band starts and read the slope there; then compare the slope at 0 and at 2.5.

+
tanh: where a neuron stops learningThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/activation/tanh_activation.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · New bends

The smooth curves of current models: GELU with its dip, Swish with its knob, and ELU with a floor instead of a cliff.

+
+
04

Lesson 4 of 27

GELU: a dip below zero

+
+

You will learnWhat GELU computes, why it dips below zero, and how close its tanh shortcut comes.

GELU weighs x by the chance that a standard normal draw is below it: GELU(x) = x Phi(x). A large positive input passes, a large negative one vanishes, and in between the curve dips to about -0.17 near x = -0.75 before it rises. BERT and GPT use it in their feed-forward layers. The exact form needs erf, which the spec computes with the Abramowitz-Stegun fit, good to 1.5e-7, and it also computes the tanh shortcut: at -0.75 they give -0.16997 and -0.17004. The spec gelu_activation.t27 computes both curves and their slopes.

Try it

Find the lowest point of the curve by its slope; then compare the exact and the tanh form at -3.

+
GELU: why transformers bend a little below zeroThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/activation/gelu_activation.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

Swish and SiLU

+
+

You will learnHow x times sigmoid(beta x) gates itself, and how one parameter moves it from a smooth curve to ReLU.

Swish is x times sigmoid(beta x), a unit that gates itself. At beta 1 it is called SiLU, and its lowest point is -0.2785 near x = -1.28. Raise beta and the gate sharpens: at beta 8 the curve is ReLU with rounded corners; at beta 0.5 it is a gentle slope through zero. One parameter moves the unit between a smooth curve and a switch, and a network can learn it. The spec silu_swish_activation.t27 computes the curve and its slope for any beta, and its own batch at -2, 0 and 2: -0.238, 0 and 1.762.

Try it

Hold x at -1.28 and raise beta from 1 to 8; then find the beta at which the dip is gone at this scale.

+
Swish: one knob between a smooth curve and ReLUThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/activation/silu_swish_activation.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

ELU: a floor, not a cliff

+
+

You will learnHow ELU keeps a soft negative side with a floor at -alpha, and why its slope never quite dies.

ELU keeps the positive side of ReLU and replaces the cliff on the negative side with alpha (e^x - 1), a curve that flattens toward -alpha. With alpha 1, x = -3 gives -0.9502, already near the floor of -1, and the slope there is 0.0498: small, but not 0, so the unit can still move. Because the negative outputs are not thrown away, a layer's outputs average closer to 0. The spec elu_activation.t27 computes the curve, the slope and the floor, and its own batch at -1, 0 and 2: -0.632, 0 and 2.

Try it

Set alpha to 0.5 and read the floor; then find how far left x must go before the slope is under 0.01.

+
ELU: a negative side with a floorThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/activation/elu_activation.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · A layer

What sits around the neurons: softmax turns scores into a choice, an embedding turns a word into numbers, dropout switches units off.

+
+
07

Lesson 7 of 27

Softmax and temperature

+
+

You will learnHow softmax turns scores into probabilities that sum to one, and what the temperature does to them.

A classifier ends with one score per class, and softmax turns the scores into probabilities: exp of each score over the sum of all of them. Scores 1, 2 and 3 become 0.090, 0.245 and 0.665. Dividing the scores by a temperature first changes how sure it is: at 0.5 the top score takes 0.867, at 5 the three are 0.27, 0.33 and 0.40. A language model picks its next token from exactly this, and the temperature setting of a chat model is this T. The spec softmax.t27 subtracts the largest score first, so exp never overflows.

Try it

Cool the temperature to 0.1 and read the three probabilities; then make a tie and heat it.

+
Softmax: how a network turns scores into a choiceThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/activation/softmax.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

Embeddings

+
+

You will learnHow a token becomes a row of numbers, and why learning changes only the rows that were read.

A network cannot multiply a word, so each token is an index into a table with one row of numbers per token, and looking a token up copies its row. In the spec the table has 4 tokens of width 2 and row v holds (10 v, 10 v + 1), so token 2 reads (20, 21). Learning sends the gradient back only to the rows that were read, and a token read twice collects both: gradient rows (1, 2) and (3, 4) on token 2 add up to (4, 6). The spec embedding_layer.t27 computes the lookup and the gradient.

Try it

Read token 2 twice and then tokens 1 and 3; count the rows whose gradient is not 0 each time.

+
Embeddings: how a word becomes a row of numbersThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/layers/embedding_layer.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Dropout

+
+

You will learnWhy switching units off while training helps, and why the survivors must be scaled.

While training, dropout switches off a share p of the units at random, so the rest cannot lean on any one of them. The units that survive must then be scaled, or the next layer would see the signal at another size in training than at inference. Inverted dropout scales them by 1 / (1 - p) while training: with p = 0.5, input 1, 2, 3, 4 becomes 2, 0, 6, 0, and inference is a plain pass. Classic dropout keeps 1, 0, 3, 0 and scales by 0.5 at inference instead. The spec dropout_layer.t27 uses a fixed mask, keep, drop, keep, drop, so the numbers are the same every time.

Try it

Compare the outputs of the four modes; then read the gradient of a dropped unit in training.

+
Dropout: training a network with neurons switched offThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/layers/dropout_layer.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · Pictures

Reading a picture in patches: a window averaged over its patch, max pooling, and batch normalisation of features on different scales.

+
+
10

Lesson 10 of 27

Patches of a picture

+
+

You will learnWhy networks read a picture in patches, and what a 2 x 2 window averaged over each patch gives.

A picture is a grid of numbers, and networks read it in small patches so that the same detector works anywhere in it. Here a 2 x 2 window steps by 2 over a 4 x 4 image whose cell i holds i, and each output is the average of its patch: 2.5, 4.5, 10.5 and 12.5. In the backward pass each output's gradient is split equally over its 4 cells. This is average pooling: a convolution would weight the 4 cells with a learned kernel, and its spec, t27#10612, is not merged yet. The spec avgpool2d_layer.t27 computes both passes.

Try it

Tap each patch and check its average by eye; then switch to the gradient and read what each cell of window 4 receives.

+
Patches of a picture: a 2 x 2 window, averagedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/layers/avgpool2d_layer.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

Max pooling

+
+

You will learnWhat max pooling keeps, where it remembers taking it from, and where the gradient goes.

Max pooling keeps the largest value of each window and drops the rest, so the network cares less about exactly where a feature sits. On the spec's 4 x 4 grid, 2 x 2 windows with stride 2 keep 4, 8, 9 and -2, taken from cells 5, 6, 13 and 11. Overlapping 3 x 3 windows with stride 1 keep 8, 8, 9 and 9. In the backward pass each window's whole gradient goes to its maximum: gradients 1, 2, 3 and 4 land on cells 5, 6, 13 and 11, and every other cell gets 0. The spec maxpool2d_layer.t27 computes the outputs, their positions and the gradient.

Try it

Switch to 3 x 3 windows and find the cell two outputs share; then turn on the gradient for 2 x 2 windows.

+
Max pooling: what a network keeps when it shrinks a pictureThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/layers/maxpool2d_layer.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

Batch normalisation

+
+

You will learnHow batch norm puts features on different scales on one scale, and what it uses at inference.

Features on different scales pull a network around: in the spec's batch one feature is ten times another. Batch normalisation subtracts each feature's batch mean and divides by its spread, so the features 1, 2, 3, 4 and 10, 20, 30, 40 both come out as -1.34, -0.45, 0.45 and 1.34, and -1, -1, 1, 1 comes out as -1 and 1. A learned gamma and beta then scale and shift it back where that helps. At inference the layer uses running averages instead of the batch: with mean 0, variance 1, gamma 1 and beta 0.25, the inputs 1, 2 and 3 give 1.25, 2.25 and 3.25. The spec batchnorm_layer.t27 computes both.

Try it

Compare the two normalised columns; then set the running mean 2 and variance 4 and read the inference outputs.

+
Batch norm: features on very different scales, made comparableThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/layers/batchnorm_layer.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · The error

How wrong a guess is, as one number: mean squared error, cross-entropy for probabilities, and the Huber loss for outliers.

+
+
13

Lesson 13 of 27

Mean squared error

+
+

You will learnHow MSE turns every miss into one number, why it chases large errors, and where its gradient points.

A loss turns all the misses of a model into one number to push down. Mean squared error averages the squared misses: predictions 1.5, 2 and 2 against targets 1, 2 and 3 cost (0.25 + 0 + 1) / 3 = 0.4167. Squaring makes a miss of 2 cost 4 times a miss of 1, so MSE chases large errors. Its gradient for each prediction is 2 (p - t) / n, here 0.333, 0 and -0.667: each prediction is pushed back toward its target. As a function of one prediction the loss is a parabola, a bowl with one bottom. The spec mse_loss.t27 computes the loss and the gradient.

Try it

Move prediction 2 onto its target and read the loss; then drag along the bowl and find its bottom.

+
Mean squared error: how wrong a guess is, as one numberThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/loss/mse_loss.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Cross-entropy

+
+

You will learnWhy cross-entropy charges a confident wrong answer so much, and why that is what trains a classifier.

A classifier outputs a probability, and cross-entropy charges -log of the probability it gave to the true answer. Predictions 0.8, 0.3 and 0.9 against answers 1, 0 and 1 cost 0.2284 on average. Being sure and right is nearly free: 0.99, 0.01 and 0.99 cost 0.0101. Being sure and wrong is expensive: 0.01, 0.99 and 0.01 cost 4.6052, and toward 0 the cost grows without bound, which is why the spec clips p to [1e-7, 1 - 1e-7]. Its gradient is largest exactly where the model is sure and wrong. The spec binary_crossentropy_loss.t27 computes the loss and the gradient, from probabilities or from logits.

Try it

Drag prediction 0 toward 0.01 and watch the curve; then read the gradient bars at 0.5, 0.5 and 0.5.

+
Cross-entropy: why a confident wrong answer costs so muchThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/loss/binary_crossentropy_loss.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

The Huber loss

+
+

You will learnHow the Huber loss treats a small error like squared error and a large one linearly, so outliers pull less.

Squared error lets one outlier dominate: an error of 3 costs 4.5 as half its square, as much as 36 errors of 0.5. Huber is half the square while |e| is within delta and then grows only linearly, delta |e| - delta^2 / 2, so with delta 1 that error costs 2.5. The two pieces meet with the same value and slope, and the gradient never grows past delta: a far-off point pulls on the model with a bounded force. For the spec's pair of errors 0.5 and 3 the mean is 1.3125, against 2.3125 for half the square. The spec huber_loss.t27 computes both.

Try it

Set delta to 0.5 and drag the error to 3; then find where the two curves part.

+
Huber loss: a loss that does not panic at an outlierThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/loss/huber_loss.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · Downhill

Walking down the loss: gradient descent with momentum, RMSProp that ignores the gradient's size, and Adam that combines them.

+
+
16

Lesson 16 of 27

Gradient descent

+
+

You will learnHow gradient descent walks down a loss, what momentum adds, and why too large a rate never settles.

Training is walking downhill on the loss. Gradient descent moves a weight by -lr times its gradient each step; in the spec the loss is (x - 3)^2 from x = 0, and lr 0.1 reaches 2.99996 in 50 steps. Momentum adds a share of the last move, which speeds up a long slope and overshoots a sharp bottom: at 0.9 the weight shoots past 3 to about 5.13 and rings down to 3.09 after 50 steps. Nesterov takes the gradient one step ahead and swings less, to about 4.25. Too large a rate never settles: at lr 1 the weight bounces between 0 and 6 for good. The spec sgd.t27 computes every step.

Try it

Find the largest learning rate that still settles without momentum; then add momentum 0.9 and count the swings.

+
Gradient descent: how a network walks downhillThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/optimizer/sgd.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

RMSProp

+
+

You will learnHow RMSProp divides each step by a running root mean square, so the step no longer depends on the gradient's size.

The right step size depends on the size of the gradient, and different weights see gradients a million times apart. RMSProp keeps a running mean of the squared gradient, the cache, and divides each step by its root, so the step has no units: with a constant gradient of 0.001, 0.5 or 1000 the weight moves by exactly the same 0.0316 on step 1 and walks the same path, reaching -0.0914 after 100 steps at lr 0.01. The decay sets how slowly the cache fills: at 0.99 the same 100 steps end at -1.0261. The spec rmsprop.t27 computes the weight and the cache.

Try it

Switch between the three gradients and check that the lines do not move; then raise the decay to 0.99.

+
RMSProp: a step that does not care how big the gradient isThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/optimizer/rmsprop.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

Adam

+
+

You will learnHow Adam combines momentum with a running scale, and why its bias correction makes step 1 a fixed size.

Adam combines the two ideas: m, a running mean of the gradient, as in momentum, and v, a running mean of its square, as in RMSProp; the step is lr m / sqrt(v). Both start at 0 and are too small early on, so Adam divides them by 1 - beta^t, and on step 1 that makes the move exactly lr times the sign of the gradient: gradients 2, -40 and 0.5 all move their weights by 0.001. On the spec's bowl (x - 3)^2 at lr 0.1, Adam rises from 0, overshoots to about 3.18 and settles at 3.00005 by step 200. The spec adam.t27 computes every step.

Try it

Give the three gradients very different sizes and read the weights after step 1; then find where the path tops out.

+
Adam: the optimizer most networks are trained withThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/optimizer/adam.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · Learning

Where the gradients come from and what they achieve: backpropagation through a layer, a network that learns XOR, and LAMB for large batches.

+
+
19

Lesson 19 of 27

Backpropagation

+
+

You will learnHow the gradient of each weight and each input of a layer follows from the gradient of its outputs.

To learn, every weight needs to know how the loss changes when it moves. Backpropagation answers one layer at a time: given g, how much the loss wants each output to move, the weight from input i to output o gets g_o x_i, and input i gets the sum over o of W[o][i] g_o, which it hands on to the layer below. With inputs (1, 2, 3) and g = (1, 0.5) the weight gradients are 1, 2, 3 and 0.5, 1, 1.5, and the input gradients 0.5, 2 and 3.5. The layer is linear, so moving x0 by 1 moves the loss g . y from 15.25 to 15.75, by its gradient 0.5. The spec dense_layer.t27 computes all three.

Try it

Set g = (1, 0) and read which edges go dark; then set g = (-2, 1) and check the input gradients by hand.

+
Backpropagation: how blame flows back through a layerThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/layers/dense_layer.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

Learning XOR

+
+

You will learnWhy one neuron cannot learn XOR, and how a hidden layer trained by backpropagation does.

XOR is 1 when exactly one of two inputs is 1. No straight line separates the cases that give 1 from those that give 0, so a single neuron cannot learn it. A hidden layer bends the space: the spec trains a 2-8-1 network of ReLUs by backpropagation, lr 0.05, from fixed initial weights. Its loss falls from 0.8896 in epoch 1 to 1.8e-13 after 2000 epochs, and its four answers come out within 4e-7 of 0, 1, 1 and 0. The widget runs that training in your browser, from scratch for every point of the curve. The spec mlp.t27 holds the network and the test that it learns.

Try it

Drag the epochs back to 100 and read the four answers; then find the epoch where the curve stops falling.

+
XOR: a network learns what one neuron cannotThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/pathway/mlp.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

LAMB and large batches

+
+

You will learnHow LAMB scales each layer's step by its own weight norm, so one learning rate suits layers of every size.

Training with very large batches needs a large learning rate, and one rate can be too large for a small layer and too small for a big one. LAMB takes an Adam-style update for each layer and rescales it by the trust ratio, the layer's weight norm, capped at 10, over the update's norm, so every layer moves by the same fraction of itself. In the spec, the weights (1, 2) times a scale take a step whose norm is 0.001 times theirs: 0.00447 at scale 2, and once the weight norm passes 10, near scale 4.47, the step stays at 0.01. The spec lamb.t27 computes the update for one layer and for two at once.

Try it

Read the step at scales 1 and 2 and compare; then drag past the bend and explain why the line goes flat.

+
LAMB: one learning rate for layers of every sizeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/optimizer/lamb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · Memory and attention

Networks that read a sequence: a recurrent cell and its fading echo, the gates of an LSTM, and attention over every position at once.

+
+
22

Lesson 22 of 27

A recurrent cell

+
+

You will learnHow a recurrent cell carries a state from step to step, and why that memory fades.

A sentence comes one word at a time, and a recurrent cell carries a state h from one step to the next: h' = tanh(W_x x + W_h h + b). In the spec's tiny cell W_x is 1 and W_h 0.5, so a single pulse gives 0.7616, 0.3634 and 0.1797: the memory of it roughly halves each step. A second pulse at step 3 lifts h to 0.7968, a little above where the single pulse began, because the old memory is still there. After 8 steps only 0.0466 is left. That fading is why plain cells forget long contexts. The spec rnn_cell.t27 computes each step.

Try it

Load one pulse and read how many steps it takes to fall under 0.1; then make the input alternate.

+
Recurrent cells: how a network remembers a moment agoThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/recurrent/rnn_cell.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

LSTM gates

+
+

You will learnHow the forget, input and output gates of an LSTM decide what the cell keeps, writes and shows.

An LSTM cell keeps a separate memory c and three gates, each a sigmoid between 0 and 1: forget scales the old memory, input lets in new content g, and output decides how much of the memory to show. c' = f c + i g and h' = o tanh(c'). In the spec's fixture every weight is 0, so each gate is the sigmoid of its bias: with the forget gate at 0.9975 and the input gate at 0.0025, a memory of 1 comes out as 0.9975, and the output is 0.7587. Because c passes through with only a multiply by f, its gradient survives many steps too. The spec lstm_single.t27 computes the cell.

Try it

Load Remember and then Forget and compare the new memory; then write with the input gate open.

+
LSTM gates: how a cell decides what to keepThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/recurrent/lstm_single.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

Attention

+
+

You will learnHow attention scores every query against every key, what a softmax over each row gives, and what the causal mask removes.

Attention lets each position decide which other positions to read. Every query is scored against every key, q . k / sqrt(d), and a softmax turns each row of scores into weights that sum to 1; the output is the values averaged by those weights. Two heads do it on the two halves of the vector. With a causal mask a position cannot read the future: in head 0, position 0 reads only itself, position 1 splits 0.452 and 0.548, and position 2 spreads 0.230, 0.321 and 0.449. Without the mask every row spreads over all three keys, from 0.21 to 0.47. The spec attention_mechanism.t27 computes every weight on its own fixture.

Try it

Turn the mask off and on and read row 0; then compare the two heads on row 2.

+
Attention: how a word decides which other words to readThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/recurrent/attention_mechanism.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · The transformer and the reward

The parts of a transformer and of an agent: positions as clocks, one encoder block, and PPO, which learns from reward without lurching.

+
+
25

Lesson 25 of 27

Positional encoding

+
+

You will learnHow sines and cosines at falling frequencies give every position its own vector, and why a shift is a turn.

Attention treats its input as a set, so the order of the words has to be added to them. The sinusoidal encoding gives each position d numbers: the sin and cos of the position times a frequency that falls by 10000^(2/d) from pair to pair. With d = 8 the four pairs turn by 1, 0.1, 0.01 and 0.001 radians per position, like the hands of four clocks: position 5 reads -0.959, 0.284 in its fast pair and 0.005, 1.000 in its slow one. Each pair has length 1, and a shift by k positions turns every pair by its own fixed angle. The spec positional_encoding.t27 computes every value.

Try it

Step from position 0 to 1 and watch which clock moves; then jump to 37 and find the pair that still points up.

+
Positional encoding: how a transformer knows word orderThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/transformer/positional_encoding.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

An encoder block

+
+

You will learnWhat one transformer encoder block does to its input, and what moving the norms in front changes.

A transformer layer is two sublayers, each wrapped in a residual add and a layer norm: self-attention mixes the positions, then a feed-forward net of width 8 works on each position alone. In the post-norm order of the original paper the block ends with a norm, so every output row has mean 0 and variance 1.000. Pre-norm puts the norms in front of each sublayer and ends on a residual add, so its rows come out at variances 2.73, 3.33 and 0.96; deep stacks train more easily that way, with one norm added at the very top. The spec encoder_block.t27 runs one block on 3 positions, d_model 4 and 2 heads.

Try it

Switch between post-norm and pre-norm and read the row variances; then find the position head 1 reads most.

+
An encoder block: what one transformer layer doesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/transformer/encoder_block.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

PPO and the reward

+
+

You will learnHow PPO turns a reward into a policy update, and how its clip keeps one update from going too far.

An agent learns from reward by making good actions more likely. PPO measures a change of policy by the ratio r of the new probability of an action to the old one and multiplies it by the advantage A, how much better the action did than expected. Then it clips: once r has moved more than eps the way A rewards, the objective goes flat. At r = 1.5, A = 1 and eps 0.2 the raw r A is 1.5, but PPO counts 1.2, so one batch cannot push the policy far. On the spec's batch, ratios 1, 1.1 and 0.9 with advantages 2, 1.5 and 3, the policy loss is -2.1167. The spec ppo_clip_loss.t27 computes it.

Try it

Make the advantage negative and find where the curve goes flat now; then widen eps to 0.5.

+
PPO: how an agent learns from reward without lurchingThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ml/rl/ppo_clip_loss.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · One neuron
    1. 01 ReLU: keep the positive part
    2. 02 The sigmoid: a number into a probability
    3. 03 tanh and saturation
  2. 02 · New bends
    1. 04 GELU: a dip below zero
    2. 05 Swish and SiLU
    3. 06 ELU: a floor, not a cliff
  3. 03 · A layer
    1. 07 Softmax and temperature
    2. 08 Embeddings
    3. 09 Dropout
  4. 04 · Pictures
    1. 10 Patches of a picture
    2. 11 Max pooling
    3. 12 Batch normalisation
  5. 05 · The error
    1. 13 Mean squared error
    2. 14 Cross-entropy
    3. 15 The Huber loss
  6. 06 · Downhill
    1. 16 Gradient descent
    2. 17 RMSProp
    3. 18 Adam
  7. 07 · Learning
    1. 19 Backpropagation
    2. 20 Learning XOR
    3. 21 LAMB and large batches
  8. 08 · Memory and attention
    1. 22 A recurrent cell
    2. 23 LSTM gates
    3. 24 Attention
  9. 09 · The transformer and the reward
    1. 25 Positional encoding
    2. 26 An encoder block
    3. 27 PPO and the reward
+ + + + + diff --git a/apps/website/public/learn/neural-networks/index.html b/apps/website/public/learn/neural-networks/index.html index b9108c39d1..cc1d4c6b2e 100644 --- a/apps/website/public/learn/neural-networks/index.html +++ b/apps/website/public/learn/neural-networks/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

Neural networks in t27: from one neuron to a transformer block

The agents of this project think with neural networks, and here their parts are written as t27 specs with tests, specs the compiler checks. Every widget runs the fn bodies of a specs/ml spec compiled to WebAssembly: move a slider and the spec answers.

Course 10, 27 lessons, a live widget and a t27 spec each: activations, softmax and embeddings, pooling and batch norm, losses, SGD, RMSProp and Adam, backpropagation and XOR, recurrent cells, attention, a transformer block and PPO. Every number is computed by a compiled spec.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/no-credit-for-keys/index.html b/apps/website/public/learn/no-credit-for-keys/index.html index 9ab62a8514..16c0b1ea22 100644 --- a/apps/website/public/learn/no-credit-for-keys/index.html +++ b/apps/website/public/learn/no-credit-for-keys/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

No credit for keys

You will learn

What a contributor's lent keys earn, and which limits keep them safe.

Anyone can lend the hive model keys through queen-contributor-keys.t27. A key is probed before it is enabled: at most 4 probes at once, a new probe waits out 60 s after the last, and an owner holds at most 100 keys. Lending earns nothing by itself: CREDIT_WALLET is false, so wallet_credit answers 0 for any number of keys. XP follows the work the Queen records.

Try it

Drag the keys from 0 to 100 and watch the credit meter; then find the second a probe may start.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Lending a key earns no credit: XP follows recorded work
Lending a key earns no credit: XP follows recorded work ↗

A contributor lends the hive model keys. Drag the keys added: the wallet credit meter stays at 0, a key slot opens up to 100, and a probe waits out its 60 s.

specs/automation/queen-contributor-keys.t27

// SPDX-License-Identifier: Apache-2.0
@@ -251,6 +283,7 @@ 

No credit for keys

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/one-edge-one-world/index.html b/apps/website/public/learn/one-edge-one-world/index.html index e2591e3d1c..88a9b8f3c2 100644 --- a/apps/website/public/learn/one-edge-one-world/index.html +++ b/apps/website/public/learn/one-edge-one-world/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

One edge, one world

You will learn

What a clock domain is, the four ways clock_domain.t27 names to cross one, and what the native compiler checks of them.

A clock domain is every flip-flop that shares one clock edge. Move a signal between two domains and the receiving edge can sample it mid-change: that is the whole subject of this course. clock_domain.t27 names the four ways across in one enum: no_cross, two_flop, fifo_async, handshake. Module 5 takes two_flop apart, module 6 the handshake, module 7 the FIFO. The recording runs the native t27c on this spec: 12 tests pass and 5 invariants are proved while it compiles. The player compiles the spec in your browser; where the browser cannot run a check it skips it and says why.

Try it

In the recording, count the passing tests and the proved invariants; then in the spec frame find the four crossing strategies and name the module of this course that takes each one apart.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on clock_domain.t27 -- the CDC spec, native
t27c on clock_domain.t27 -- the CDC spec, native ↗

t27c 0.4.0 on a laptop (macOS): 12 tests of the clock-domain spec pass natively, 5 invariants proved comptime, and the spec's own header says what it models.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

One edge, one world

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/one-lut-up-close/index.html b/apps/website/public/learn/one-lut-up-close/index.html index c9246907e5..255ccd2ccd 100644 --- a/apps/website/public/learn/one-lut-up-close/index.html +++ b/apps/website/public/learn/one-lut-up-close/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

One LUT, up close

You will learn

What a 6-input lookup table is, and how 64 bits describe any gate.

A LUT6 is a tiny memory with 6 address inputs and 64 one-bit entries. Any logic function of 6 inputs is just its truth table written into those 64 bits, the INIT value. Paste an INIT and the widget reads it back as a truth table and an expression. Then play the guessing game on LUTs taken from a real routed design: XOR, AND, a multiplexer, or something with no short name.

Try it

Try the XOR6 and majority examples, then play five rounds of Guess the gate. In the spec frame, full_adder is built from xor2 and maj3: which one makes the carry, and how many neurons does the spec say it takes?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

LUT explain: a 7-series LUT6 INIT and its FASM line, read as logic
LUT explain: a 7-series LUT6 INIT and its FASM line, read as logic ↗

Paste a 64-bit LUT6 INIT or FASM lines: truth table, minimal expression, the gate's name, what each feature sets. Then guess the gate on 4738 LUTs from a routed design.

specs/ternary/ternary_full_adder.t27

module TernaryFullAdder;
@@ -146,6 +178,7 @@ 

One LUT, up close

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/one-outlier/index.html b/apps/website/public/learn/one-outlier/index.html index ea500ae2ef..22f4b442c9 100644 --- a/apps/website/public/learn/one-outlier/index.html +++ b/apps/website/public/learn/one-outlier/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

One outlier, many zeros

You will learn

What a shared scale costs: how one large weight pushes the small weights of its block to zero, format by format.

A shared scale is set by the largest value in its block, so one outlier sets it for all 32 weights. Weights much smaller than the outlier then fall below the smallest step the element can show and are stored as zero. This recording runs ocp_mx.t27, our spec of OCP MX v1.0, natively on a block of 31 small weights and one outlier, and counts how many each element format flushes to zero. Then it plants a bug, one changed exponent bias, and exactly one test fails: a spec that carries its tests catches its own mistakes.

Try it

Read which element format flushes the most small weights to zero and which two flush none; then find the test the planted bug breaks. A 4-bit element has a narrow range: in the spec frame, find max_value and min_positive of GF4 and the two tests that pin them.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on ocp_mx.t27 -- OCP MX v1.0, native
t27c on ocp_mx.t27 -- OCP MX v1.0, native ↗

t27c 0.4.0 and zig 0.16.0 on the t27c lab (Railway), spec at t27 1a3786657: 49 tests pass natively; one changed bias makes exactly one test fail; git restores the spec.

specs/numeric/gf4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -373,6 +405,7 @@ 

One outlier, many zeros

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/one-scale-per-block/index.html b/apps/website/public/learn/one-scale-per-block/index.html index 9b8b7c6e42..2842198fd3 100644 --- a/apps/website/public/learn/one-scale-per-block/index.html +++ b/apps/website/public/learn/one-scale-per-block/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

One scale for a block of weights

You will learn

Why AI formats share one scale across a block of weights, and how the scale byte of OCP MX is read.

A language model has millions of weights, and a full float for each is expensive to store and to move. The Microscaling (MX) formats of the Open Compute Project keep each weight in 4, 6 or 8 bits and give every block of 32 weights one shared scale. That scale is a single byte called E8M0: no sign and no mantissa, only an exponent, so code e means 2 to the power e minus 127, and code 255 means NaN. The player compiles e8m0.t27, the spec of that byte, in your browser and runs its tests. Where the browser cannot run a check, it skips it and says why.

Try it

Run the tests and count the skips; then open the Verilog and find the function that checks for code 255. In the spec frame, the catalog gives FP4 E2M1 and MXFP4 the same bits: compare their storage fields and find what MXFP4 adds.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

e8m0.t27, the OCP MX scale byte, compiled inside the post
e8m0.t27, the OCP MX scale byte, compiled inside the post ↗

The OCP MX shared scale as a t27 spec, compiled by t27c as WebAssembly in your browser: one byte, 2^(e-127), code 255 is NaN. Seven backends, the spec's own tests and its Verilog.

specs/numeric/formats_catalog.t27

// SPDX-License-Identifier: Apache-2.0
@@ -563,6 +595,7 @@ 

One scale for a block of weights

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/one-step-downhill/index.html b/apps/website/public/learn/one-step-downhill/index.html index 386f6fada6..1b5991dad3 100644 --- a/apps/website/public/learn/one-step-downhill/index.html +++ b/apps/website/public/learn/one-step-downhill/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

One step downhill

You will learn

How one SGD step moves a weight against its gradient, and why a test with two equal inputs cannot tell them apart.

gft_sgd_step.t27 moves a weight against its gradient: w' = w - eta*g, where eta is the learning rate. Its 3 tests are step, with w = 1.0, g = 0.5 and eta = 0.5; nograd, where g = 0 leaves w alone; and ascend, where g = -1.0 and eta = 1.0 push w up to 2.0. The browser skips all 3 tests because its runner does not know assert_eq yet; the native t27c runs all 3, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that multiplies g by itself instead of by eta, and t27c test-report again. In step g equals eta, and in nograd both products are 0. So exactly one test fails, ascend, where the weight falls to 0 instead of rising to 2.0. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find step and decide which of its inputs must change for it to catch the bug.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_sgd_step.t27 -- one step downhill, native
t27c on gft_sgd_step.t27 -- one step downhill, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 3 tests pass natively, none vacuous; g times g in place of eta times g makes exactly one test fail, ascend; git restores the spec.

specs/ternary/gft_sgd_step.t27

module GftSgdStep;
@@ -196,6 +228,7 @@ 

One step downhill

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/one-task-three-kinds/index.html b/apps/website/public/learn/one-task-three-kinds/index.html index 1397a36013..9a73e42147 100644 --- a/apps/website/public/learn/one-task-three-kinds/index.html +++ b/apps/website/public/learn/one-task-three-kinds/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

One task, three kinds

You will learn

How an issue, a review and a job become one kind of task with seven states, and how one filter reads them.

The Queen runs three kinds of work: issues for bees, reviews of finished work, and jobs. Each kept its own codes, so no board could show them together. tasks.t27 gives them 7 shared states, numbered as the board's columns plus failed. A cancelled job shows as dropped, and so does a review row that was forgotten. task_matches is the filter the board, the game and the route all apply: a bit per kind, a bit per state, and 0 means any.

Try it

Show only failed tasks of every kind; then find which job state shows as dropped.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

One task, three kinds: the filter the board and the game share
One task, three kinds: the filter the board and the game share ↗

An issue, a review and a job are one kind of task with seven states. Tap kinds and states: the grid lights every pair task_matches lets through.

specs/queen/tasks.t27

// SPDX-License-Identifier: Apache-2.0
@@ -217,6 +249,7 @@ 

One task, three kinds

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/one-ternary-neuron/index.html b/apps/website/public/learn/one-ternary-neuron/index.html index 15310ba67b..39cbb3dd30 100644 --- a/apps/website/public/learn/one-ternary-neuron/index.html +++ b/apps/website/public/learn/one-ternary-neuron/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

One ternary neuron

You will learn

How a neuron with weights -1, 0, +1 computes without multiplying.

A neuron multiplies each input by a weight, adds the products and compares the sum with a threshold. With ternary weights every product is a copy, a zero or a flip, so the sum is adds and subtracts only. The spec's activate() answers +1 at or above the threshold, -1 at or below minus it and 0 between: a neuron that can say not sure.

Try it

Draw a vertical bar on the input and raise the threshold until the neuron stops firing; then press weights until it fires on a horizontal bar.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

One ternary neuron: inputs, weights, a threshold
One ternary neuron: inputs, weights, a threshold ↗

Nine inputs and nine weights of -1, 0, +1. Each product is a copy, a zero or a flip; the sum against a threshold gives an output trit.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

One ternary neuron

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/opposite-signs-subtract/index.html b/apps/website/public/learn/opposite-signs-subtract/index.html index 9ab4240d9b..7c7dd4e3bd 100644 --- a/apps/website/public/learn/opposite-signs-subtract/index.html +++ b/apps/website/public/learn/opposite-signs-subtract/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Opposite signs subtract

You will learn

How a signed add turns into a subtraction when the signs differ, and what its 3 tests leave unchecked.

sadd in gft_sadd.t27 adds two numbers of the same sign with magadd. When the signs differ it subtracts the smaller size from the larger with magsub, takes the sign of the larger, and returns 0 on an exact cancellation. The browser skips all 3 tests because its runner does not know assert_eq yet; the native t27c runs all 3, all pass, none vacuous. Only a2, 1.0 plus -1.0, mixes signs, and it cancels: magsub returns 0 at once because both sizes are equal. No test subtracts two different sizes, so the sign of the larger never decides a result. The recording runs t27c test-report, then a one-line sed that adds the sizes in the branch a2 takes, and t27c test-report again: exactly one test fails, a2. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the value a2 expects; then in the spec frame find bsign and check whether a1, a2 or a3 ever depends on it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_sadd.t27 -- opposite signs subtract, native
t27c on gft_sadd.t27 -- opposite signs subtract, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 3 tests pass natively, none vacuous; adding the sizes where opposite signs must subtract makes exactly one test fail, a2; git restores the spec.

specs/ternary/gft_sadd.t27

module GftSadd;
@@ -189,6 +221,7 @@ 

Opposite signs subtract

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/patches-of-a-picture/index.html b/apps/website/public/learn/patches-of-a-picture/index.html index 6a1c7df339..9592f3c652 100644 --- a/apps/website/public/learn/patches-of-a-picture/index.html +++ b/apps/website/public/learn/patches-of-a-picture/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Patches of a picture

You will learn

Why networks read a picture in patches, and what a 2 x 2 window averaged over each patch gives.

A picture is a grid of numbers, and networks read it in small patches so that the same detector works anywhere in it. Here a 2 x 2 window steps by 2 over a 4 x 4 image whose cell i holds i, and each output is the average of its patch: 2.5, 4.5, 10.5 and 12.5. In the backward pass each output's gradient is split equally over its 4 cells. This is average pooling: a convolution would weight the 4 cells with a learned kernel, and its spec, t27#10612, is not merged yet. The spec avgpool2d_layer.t27 computes both passes.

Try it

Tap each patch and check its average by eye; then switch to the gradient and read what each cell of window 4 receives.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Patches of a picture: a 2 x 2 window, averaged
Patches of a picture: a 2 x 2 window, averaged ↗

Tap a window on the 4 x 4 image: each output is the average of its 2 x 2 patch, two cells apart. Then switch to the gradient and see each output's blame shared out over its patch.

specs/ml/layers/avgpool2d_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -290,6 +322,7 @@ 

Patches of a picture

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/period-and-jitter/index.html b/apps/website/public/learn/period-and-jitter/index.html index 9708d2bd67..90deba1509 100644 --- a/apps/website/public/learn/period-and-jitter/index.html +++ b/apps/website/public/learn/period-and-jitter/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A period, an edge, and jitter

You will learn

What a clock carries besides frequency, what jitter does to an edge, and what a tool-card spec is for.

A clock is a period with an edge in it, and the edge is not perfectly placed: cycle to cycle it wanders by the jitter. The spec of the tri clocks tool card is not a test suite, and the recording shows its native report saying exactly that: 0 tests, because it is constants a tool page reads. Every constant on that card names the tool output it came from. Jitter eats the margin a setup calculation leaves: the clock-tree spec of the next module carries 50 ps of PLL jitter as one of its constants.

Try it

In the recording, find the line that says why the report counts 0 tests; then in the spec frame read the constants and find where each names the tool output it came from.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on clocks.t27 -- the tri clocks card, native
t27c on clocks.t27 -- the tri clocks card, native ↗

t27c 0.4.0 on a laptop (macOS): the tri clocks tool-card spec reports 0 tests -- it is constants for a tool page, not a test suite; the first lines show what it carries.

specs/tools/trios/tri/clocks.t27

// SPDX-License-Identifier: Apache-2.0
@@ -105,6 +137,7 @@ 

A period, an edge, and jitter

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/phase-and-lock/index.html b/apps/website/public/learn/phase-and-lock/index.html index f8ba7dcd2f..8c3f0a594c 100644 --- a/apps/website/public/learn/phase-and-lock/index.html +++ b/apps/website/public/learn/phase-and-lock/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Phase and lock

You will learn

How fine the phase knob is, how the lock model behaves, and what one widened window breaks.

Phase moves in steps of the VCO period divided by 56 -- a faster VCO is a finer knob, which is why phase work wants the VCO high. Lock is modelled with a settling window the header labels as an assumption. The recording widens that assumption by one sed: VCO_MIN_KHZ from 800000 to 400000. The 500 MHz configuration the rejection test names slides inside the widened window, and exactly one test fails, vco_below_the_window_is_rejected -- a test that names the number it refuses is a test that guards the assumption. The recording puts the line back and prints the sha256 of the restored spec.

Try it

In the recording, find the sed line, the test that fails and the sha256 of the restored spec; then in the spec frame compute the phase step for a 1000 MHz VCO.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on mmcm.t27 -- widen the VCO window, one test objects
t27c on mmcm.t27 -- widen the VCO window, one test objects ↗

VCO_MIN_KHZ 800000 to 400000 in one sed: the 500 MHz config the rejection test calls out slides inside the widened window and vco_below_the_window_is_rejected fails; git restores the spec.

specs/fpga/mmcm.t27

// SPDX-License-Identifier: Apache-2.0
@@ -339,6 +371,7 @@ 

Phase and lock

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/phi-as-a-ratio/index.html b/apps/website/public/learn/phi-as-a-ratio/index.html index ce29f78fde..482175103f 100644 --- a/apps/website/public/learn/phi-as-a-ratio/index.html +++ b/apps/website/public/learn/phi-as-a-ratio/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Phi as a ratio

You will learn

How phi_ratio.t27 computes a split for any width, and why the distance from 1 / phi does not shrink at every step.

phi_ratio.t27 sets PHI_RATIO_TARGET to 1 / phi, about 0.618, and its function phi_split works for any width: of the N - 1 bits after the sign, round((N - 1) / phi^2) go to the exponent and the rest to the mantissa. Its table verify_phi_split holds seven widths, and all seven match the family: GF4 splits 1 and 2, GF8 3 and 4, GF12 4 and 7, GF16 6 and 9, GF20 7 and 12, GF24 9 and 14, GF32 12 and 19. The distance from 1 / phi does not fall at every step: GF8 at 0.132 is further than GF4 at 0.118, and GF16 at 0.049 is further than GF12 at 0.047.

Try it

Run the tests of phi_ratio.t27 and find the one that checks GF16 at 6 and 9. Then compute 3 / 4 and 4 / 7 against 0.618 and say which is further.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 2: phi as a ratio
GoldenFloat 2: phi as a ratio ↗

Seven widths split by one rule, and how far each sits from 1 / phi, read from phi_ratio.t27. Lesson 2 of the GoldenFloat course.

specs/numeric/phi_ratio.t27

// SPDX-License-Identifier: Apache-2.0
@@ -826,6 +858,7 @@ 

Phi as a ratio

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/phi-in-sixteen-bits/index.html b/apps/website/public/learn/phi-in-sixteen-bits/index.html index 758f9f1744..0935a47a72 100644 --- a/apps/website/public/learn/phi-in-sixteen-bits/index.html +++ b/apps/website/public/learn/phi-in-sixteen-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Phi in sixteen bits

You will learn

How a spec checks that GF16 keeps phi, phi^2 = phi + 1 and phi^2 + 1/phi^2 = 3 within a stated tolerance.

A format is only as good as the identities it keeps. gf_competitive.t27 holds five checks: phi stored in GF16 against its true value, phi^2 against phi + 1, the sum phi^2 + 1/phi^2 against 3, a round trip, and a sum of 1000 terms. Read them as they are: the values in each test are written into the test, not produced by an encoder in this spec. The spec checks the arithmetic of the error, with tolerances of 1e-4 and 5e-3.

Try it

Run the tests and find the value each test writes in for phi^2 and for phi + 1. Then find which two tests use the tighter tolerance of 1e-4.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 6: phi in sixteen bits
GoldenFloat 6: phi in sixteen bits ↗

The five checks of gf_competitive.t27, read from gf_competitive.t27. Lesson 6 of the GoldenFloat course.

specs/numeric/gf_competitive.t27

// SPDX-License-Identifier: Apache-2.0
@@ -175,6 +207,7 @@ 

Phi in sixteen bits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/phi-scaled-ternary/index.html b/apps/website/public/learn/phi-scaled-ternary/index.html index ebcee147a7..dbd44900be 100644 --- a/apps/website/public/learn/phi-scaled-ternary/index.html +++ b/apps/website/public/learn/phi-scaled-ternary/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Weights of minus phi, zero and plus phi

You will learn

How a ternary weight is stored in 2 bits, what the fourth code is for, and what the spec does not claim about phi.

Ternary networks such as BitNet keep each weight as minus one, zero or plus one times a scale, so a multiply becomes an add, a subtract or nothing. gfternary.t27 fixes that scale at phi, about 1.618, and stores the three values in 2 bits: 00 is zero, 01 is plus phi, 10 is minus phi. Two bits have a fourth code, 11, and the spec folds it to zero instead of leaving it undefined. The spec also says what it does not claim: that a phi scale beats plain integer ternary weights is an open conjecture, and it names the measured gap that would falsify it. The player compiles it in your browser; most checks it cannot run here, and each skip says why.

Try it

Run the tests and read why the skips were skipped; then find the code that folds to zero and the line that folds it. The golden ratio can also size a format: in the spec frame, find golden_section and read how gft4 splits 4 positions between sign, trits and mantissa.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

gfternary.t27, phi-scaled ternary weights, compiled inside the post
gfternary.t27, phi-scaled ternary weights, compiled inside the post ↗

Two-bit ternary weights {-phi, 0, +phi} as a t27 spec, compiled by t27c as WebAssembly in your browser. Seven backends; every test the page cannot run says why.

specs/numeric/gft4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -123,6 +155,7 @@ 

Weights of minus phi, zero and plus phi

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/pick-the-largest/index.html b/apps/website/public/learn/pick-the-largest/index.html index 85ec182be2..fc0258e066 100644 --- a/apps/website/public/learn/pick-the-largest/index.html +++ b/apps/website/public/learn/pick-the-largest/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Pick the largest

You will learn

How argmax names a class by comparing bits alone, and which rule settles a tie.

A classifier ends by naming the class with the largest score. gft_argmax4.t27 does it with no arithmetic: gt ranks negatives below zero and zero below positives, then compares the low 16 bits, which grow with the size. Its header says the lowest index wins ties, strict >. The browser skips all 4 tests because its runner does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that turns > into >= for two positive scores, and t27c test-report again: exactly one test fails, tie_low: four scores of 1.0 now pick index 3, not 0. No test lets two negative scores decide the answer: reversing their comparison fails nothing. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame find the line that compares two negative scores and the one test that reaches it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_argmax4.t27 -- pick the largest, native
t27c on gft_argmax4.t27 -- pick the largest, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; >= in place of > for two positive scores makes exactly one test fail, tie_low; git restores the spec.

specs/ternary/gft_argmax4.t27

module GftArgmax4;
@@ -119,6 +151,7 @@ 

Pick the largest

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/pins-and-package/index.html b/apps/website/public/learn/pins-and-package/index.html index 9e43949ddd..42eca837e8 100644 --- a/apps/website/public/learn/pins-and-package/index.html +++ b/apps/website/public/learn/pins-and-package/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Pins, balls and the package

You will learn

How the signals of your design reach the outside world.

A chip sits in a package: the XC7A200T on our board has 676 solder balls under it. Some carry power or configuration and only some are user IO, grouped into banks with their own voltage. A constraints file (XDC) says which ball each signal of your design uses. Put a signal on a ball that is not user IO and the build fails, or worse, the board does not do what you think.

Try it

Search for a ball name like E3, then colour by pin type and find a ball that is not user IO. The spec frame pins a small design to another package, the XC7A100T in CSG324: find the test that puts its clock on ball E3, and the one that counts its pins.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Pin map: the XC7A200T FGG676 package ball by ball, with an XDC lint
Pin map: the XC7A200T FGG676 package ball by ball, with an XDC lint ↗

All 676 balls of the XC7A200T FGG676 by bank and type, with our board's pins on top. Paste or drop an XDC: it is linted in your browser and sent nowhere.

specs/boards/xc7a100t_minimal.t27

// SPDX-License-Identifier: Apache-2.0
@@ -460,6 +492,7 @@ 

Pins, balls and the package

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/placement/index.html b/apps/website/public/learn/placement/index.html index d6d4640283..0f2a719bd5 100644 --- a/apps/website/public/learn/placement/index.html +++ b/apps/website/public/learn/placement/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Placement: where the cells land

You will learn

What place and route does, and where it put a real design.

Synthesis says which cells you need. Place and route decides where each one sits on the die and which wires connect them. nextpnr-xilinx does both in the open flow. The map draws every placed cell of a real run on the XC7A200T: a small design is a small cluster in a huge chip.

Try it

Fit the design, then tap cells of different types and read their BEL names. In the spec frame, find RegionKind: which two of its five kinds are columns, and which test checks that a BRAM column is 1 wide?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Placement map: where nextpnr put every cell on the XC7A200T
Placement map: where nextpnr put every cell on the XC7A200T ↗

Every LUT, FF, CARRY4, IO and clock buffer of a real nextpnr-xilinx run, drawn on its site of the Artix-7 200T die. Drop your routed JSON and it draws yours.

specs/fpga/placement.t27

// SPDX-License-Identifier: Apache-2.0
@@ -310,6 +342,7 @@ 

Placement: where the cells land

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/plan-before-code/index.html b/apps/website/public/learn/plan-before-code/index.html index a6270fef4a..ff6b5bc312 100644 --- a/apps/website/public/learn/plan-before-code/index.html +++ b/apps/website/public/learn/plan-before-code/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Plan before code

You will learn

How a verification plan is a checklist that a command can sweep and sign.

A test plan written after the code is a description of what the code does; written before, it is a claim the code must live up to. In this repo the plan is a spec, and a command sweeps it. The widget is that sweep for the bench tools: 14 of 14 pass their own self-tests in one run -- decode 18/18, repin 17/17 -- and any tool that cannot check itself is listed, not waved through. The lesson's spec is build_verify: the checklist of what a build must show before anyone calls it done.

Try it

Run the tool sweep and find the one tool whose self-test is listed rather than run; then read build_verify's checklist and mark which items are counts and which are claims.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-tools · 14 bench tools test themselves
tri fpga-tools · 14 bench tools test themselves ↗

14 of 14 bench tools pass their own self-tests in one sweep: decode 18/18, repin 17/17, firelog 10/10, tmpcheck 9/9, stamps 9/9, keep 9/9, jtag and seeds PASS.

specs/fpga/verification/build_verify.t27

// SPDX-License-Identifier: Apache-2.0
@@ -191,6 +223,7 @@ 

Plan before code

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/pointers-and-flags/index.html b/apps/website/public/learn/pointers-and-flags/index.html index ecbcd88219..c3cbe40be3 100644 --- a/apps/website/public/learn/pointers-and-flags/index.html +++ b/apps/website/public/learn/pointers-and-flags/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Pointers and flags

You will learn

How the flags are derived from the pointers, which signals actually cross, and what one flipped assignment breaks.

The data does not cross; it lives in BRAM and both sides address it. What crosses is the pointers, in Gray, and the flags derived from them: empty when the pointers match, full when they differ by the depth. The recording breaks the flag arithmetic with one flipped assignment -- push sets flags.empty to true -- and exactly one test fails, push_increments_fill, the one that asks a push for a non-empty FIFO. The recording restores the spec and prints its sha256. The spec frame opens fifo.t27, where push and pop build the flags the crossing carries.

Try it

In the recording, find the flipped assignment and the one test that fails; then in the spec frame find where push builds the flags and derive empty from the pointers yourself.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on fifo.t27 -- break a flag, one test objects
t27c on fifo.t27 -- break a flag, one test objects ↗

push sets flags.empty = false; one sed flips it to true and push_increments_fill fails on the next run; git restores the spec.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Pointers and flags

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/polyphase/index.html b/apps/website/public/learn/polyphase/index.html index 2010749016..7eabda8b76 100644 --- a/apps/website/public/learn/polyphase/index.html +++ b/apps/website/public/learn/polyphase/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Polyphase

You will learn

How the polyphase form does the filtering of a decimator at the low rate.

Filtering at the input rate and throwing R - 1 of every R outputs away wastes R - 1 of every R multiplies. Deal the taps into R phases by k mod R instead: each phase is a short filter that only ever meets every R-th input, so all of them run at the output rate. A 31-tap decimate-by-4 filter falls from 124 MACs per output to 31. The spec signals.t27 computes the phases and the counts.

Try it

Find a tap count that splits evenly into 4 phases and one that does not; then compare the MACs at R = 8.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Polyphase: do the work at the low rate
Polyphase: do the work at the low rate ↗

Set taps and a decimation factor. The taps are dealt into R short filters that each run at the output rate, and the work per output drops by R.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Polyphase

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/ports-and-kinds/index.html b/apps/website/public/learn/ports-and-kinds/index.html index a1013e1f9d..c675dce638 100644 --- a/apps/website/public/learn/ports-and-kinds/index.html +++ b/apps/website/public/learn/ports-and-kinds/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Ports and kinds

You will learn

What a port is on a memory, how many a memory may have, and who may write.

A port is a lane into the memory: read, write or both, and MAX_MEM_PORTS 8 bounds them. add_read_port_increments, add_write_port_increments and add_rw_port check the counting, is_rom checks that a read-only kind refuses a write port. The recording runs t27c check on the spec: 0 errors, 0 warnings.

Try it

In the recording, find the error and warning counts; then in the spec frame find MAX_MEM_PORTS and the test that refuses a write port on ROM.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c check on memory.t27 -- the spec compiles
t27c check on memory.t27 -- the spec compiles ↗

t27c check typechecks the memory spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/memory.t27

// SPDX-License-Identifier: Apache-2.0
@@ -422,6 +454,7 @@ 

Ports and kinds

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/positional-encoding/index.html b/apps/website/public/learn/positional-encoding/index.html index e23fe0c416..75c0efef94 100644 --- a/apps/website/public/learn/positional-encoding/index.html +++ b/apps/website/public/learn/positional-encoding/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Positional encoding

You will learn

How sines and cosines at falling frequencies give every position its own vector, and why a shift is a turn.

Attention treats its input as a set, so the order of the words has to be added to them. The sinusoidal encoding gives each position d numbers: the sin and cos of the position times a frequency that falls by 10000^(2/d) from pair to pair. With d = 8 the four pairs turn by 1, 0.1, 0.01 and 0.001 radians per position, like the hands of four clocks: position 5 reads -0.959, 0.284 in its fast pair and 0.005, 1.000 in its slow one. Each pair has length 1, and a shift by k positions turns every pair by its own fixed angle. The spec positional_encoding.t27 computes every value.

Try it

Step from position 0 to 1 and watch which clock moves; then jump to 37 and find the pair that still points up.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Positional encoding: how a transformer knows word order
Positional encoding: how a transformer knows word order ↗

Every position gets 8 numbers, sines and cosines at frequencies falling by 10 per pair. Drag the position: the fast clock spins, the slow ones barely move, and the stripes show all 48 rows.

specs/ml/transformer/positional_encoding.t27

// SPDX-License-Identifier: Apache-2.0
@@ -156,6 +188,7 @@ 

Positional encoding

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/ppo-and-the-reward/index.html b/apps/website/public/learn/ppo-and-the-reward/index.html index d092d2e233..2171e165e7 100644 --- a/apps/website/public/learn/ppo-and-the-reward/index.html +++ b/apps/website/public/learn/ppo-and-the-reward/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

PPO and the reward

You will learn

How PPO turns a reward into a policy update, and how its clip keeps one update from going too far.

An agent learns from reward by making good actions more likely. PPO measures a change of policy by the ratio r of the new probability of an action to the old one and multiplies it by the advantage A, how much better the action did than expected. Then it clips: once r has moved more than eps the way A rewards, the objective goes flat. At r = 1.5, A = 1 and eps 0.2 the raw r A is 1.5, but PPO counts 1.2, so one batch cannot push the policy far. On the spec's batch, ratios 1, 1.1 and 0.9 with advantages 2, 1.5 and 3, the policy loss is -2.1167. The spec ppo_clip_loss.t27 computes it.

Try it

Make the advantage negative and find where the curve goes flat now; then widen eps to 0.5.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

PPO: how an agent learns from reward without lurching
PPO: how an agent learns from reward without lurching ↗

Drag the probability ratio of a new policy over the old: PPO's objective follows r times the advantage until r moves more than eps the rewarded way, then it goes flat and stops pulling.

specs/ml/rl/ppo_clip_loss.t27

// SPDX-License-Identifier: Apache-2.0
@@ -265,6 +297,7 @@ 

PPO and the reward

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/prefix-adders/index.html b/apps/website/public/learn/prefix-adders/index.html index 6623cf5fef..53db52bd51 100644 --- a/apps/website/public/learn/prefix-adders/index.html +++ b/apps/website/public/learn/prefix-adders/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Looking ahead: prefix adders

You will learn

How a prefix network computes every carry in log2 n levels, and what Kogge-Stone, Sklansky and Brent-Kung pay for it.

The carries of an adder are prefixes of one associative operator, so they can be computed as a tree instead of a chain. The widget draws four networks from the spec's src() function, one dot per prefix cell. At 16 bits ripple needs 15 levels; Kogge-Stone needs 4 levels and 49 cells, Brent-Kung 7 levels and 26 cells, Sklansky 4 levels and 32 cells with a fanout of 8. The spec does not take the counts on trust: covers() replays each network on spans and checks that every column ends up covering bits 0 to i.

Try it

At 16 bits, tap bit 15 in each network and count the white dots; then name the network with the fewest levels and the one with the fewest cells.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Prefix adders: trade logic levels for cells and wires
Prefix adders: trade logic levels for cells and wires ↗

Pick a width and a network -- ripple, Sklansky, Kogge-Stone, Brent-Kung -- and see every carry cell. Tap a bit to light the cells its carry waits for.

specs/fpga/dsp/adders.t27

// SPDX-License-Identifier: Apache-2.0
@@ -552,6 +584,7 @@ 

Looking ahead: prefix adders

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/psel-and-penable/index.html b/apps/website/public/learn/psel-and-penable/index.html index c29e70ddf5..a342dff973 100644 --- a/apps/website/public/learn/psel-and-penable/index.html +++ b/apps/website/public/learn/psel-and-penable/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

PSEL and PENABLE

You will learn

How the APB two-phase handshake works, and what the compiler emits for the bridge.

APB moves a transfer in two phases: setup, where PSEL names the servant and the address settles, and access, where PENABLE rises and the transfer completes. The spec's ApbTransfer enum carries the kinds, and the bench of the twelfth lesson drives write and read through them. The recording lowers the APB bridge spec to synthesizable Verilog: the port list, the wiring, the decode.

Try it

In the recording, find the bridge's port list; then in the spec frame find the ApbTransfer kinds and say which phase PENABLE names.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on apb_bridge.t27 -- spec to RTL
t27c gen-verilog on apb_bridge.t27 -- spec to RTL ↗

The APB bridge spec lowered to synthesizable Verilog: port list, PSEL and PENABLE wiring, the address decode.

specs/fpga/apb_bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -415,6 +447,7 @@ 

PSEL and PENABLE

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/pub-or-private/index.html b/apps/website/public/learn/pub-or-private/index.html index 35fcb66b03..4514881298 100644 --- a/apps/website/public/learn/pub-or-private/index.html +++ b/apps/website/public/learn/pub-or-private/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

pub or private

You will learn

What pub declares, and what the TypeScript backend writes with and without it.

pub in front of const, fn, struct or enum says other modules may use the name. Without pub the name is meant for the module itself. Today the compiler does not enforce this in the code it writes: gen-ts exports both the pub and the private constant of the lesson spec. Use pub to say what a module offers, and read the generated code before relying on privacy.

Try it

Open the ts tab of the lesson spec in the player and find both constants.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 16: what pub changes in the generated code
t27 basics 16: what pub changes in the generated code ↗

A pub and a private t27 constant side by side with the TypeScript the real compiler wrote for each. Lesson 16 of the t27 basics course.

specs/basics/16_pub_or_private.t27

// SPDX-License-Identifier: Apache-2.0
@@ -81,6 +113,7 @@ 

pub or private

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/q-formats/index.html b/apps/website/public/learn/q-formats/index.html index 705c77348b..36cf571684 100644 --- a/apps/website/public/learn/q-formats/index.html +++ b/apps/website/public/learn/q-formats/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Q formats

You will learn

How to read and write a Qm.n fixed-point word: its range, its step and the bits around the binary point.

Qm.n has m integer bits counting the sign and n fraction bits; the word stands for its integer value times 2^-n. Q1.15 is a 16-bit word from -1 to 0.99997 in steps of 2^-15. 0.7 has no exact Q1.15 word: the nearest is 22938, worth 0.70001. The top bit weighs minus its place, which is all two's complement is. The spec fixed_point.t27 computes the range, the step, every bit and the word a value rounds to.

Try it

Store 0.7 in Q1.15 and read the error; then switch to Q2.2 and list every value the format can hold.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Q formats: read and write a fixed-point number
Q formats: read and write a fixed-point number ↗

Pick Qm.n, drag a value or tap the bits, and see where the binary point sits, what the word is worth, its range and its step.

specs/fpga/dsp/fixed_point.t27

// SPDX-License-Identifier: Apache-2.0
@@ -344,6 +376,7 @@ 

Q formats

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/quantization-noise/index.html b/apps/website/public/learn/quantization-noise/index.html index 7bfbc972d5..3e92513767 100644 --- a/apps/website/public/learn/quantization-noise/index.html +++ b/apps/website/public/learn/quantization-noise/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Quantization noise

You will learn

Why each bit of a quantizer buys about 6 dB, and where the textbook formula is optimistic.

A quantizer's error is a sawtooth one step high, and its power is the step squared over 12. Against a full-scale sine that gives 6.02 N + 1.76 dB, about 74.0 dB at 12 bits. The spec signals.t27 also measures it: it quantizes a real sine over 4096 samples holding 127 periods and divides the powers. At 12 bits the two agree; at 1 bit the formula claims 7.78 dB and the measurement finds 6.44, because so coarse an error is not uniform.

Try it

Step from 1 to 4 bits and watch the gap between the formula and the measurement close; then read what the 16th bit adds.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Quantization noise: each bit buys about 6 dB
Quantization noise: each bit buys about 6 dB ↗

Pick a quantizer width and see the staircase, its error, and the signal-to-noise ratio measured on a real sine next to the textbook 6.02 N + 1.76 dB.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Quantization noise

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/queen-and-hive/all/card.png b/apps/website/public/learn/queen-and-hive/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..0190daa1d4dfa298602155f062ba09b68a44c3ea GIT binary patch literal 37474 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 MqOzY#h4sJve~swpi2wiq literal 0 HcmV?d00001 diff --git a/apps/website/public/learn/queen-and-hive/all/index.html b/apps/website/public/learn/queen-and-hive/all/index.html new file mode 100644 index 0000000000..267b973148 --- /dev/null +++ b/apps/website/public/learn/queen-and-hive/all/index.html @@ -0,0 +1,482 @@ + + + + + + +The Queen and the hive: how the t27 project builds itself: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

The Queen and the hive: how the t27 project builds itself

+

This project builds itself: an issue becomes a task for a bee, the bee writes a t27 spec, a reviewer bee checks it, it merges, and the site regenerates. The Queen who runs that loop is written as t27 specs with tests, and every widget here runs the fn bodies of one of them compiled to WebAssembly.

+

Course 11, 27 lessons, a live widget and a t27 spec each: shaping an issue, priority and review first, a task's life, the reviewer and the merge gate, the review jam, keys, credit and tokens, agents in one group, the night watch and the board. Every answer comes from a compiled spec.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · The task

An issue becomes work only once it is shaped: the sections it lacks are written or asked for, its boundary names real files, and one filter reads every kind of task.

+
+
01

Lesson 1 of 27

Shaping an issue

+
+

You will learnWhat the Queen does with an issue that lacks sections, and why she stops after two tries.

A bee can start only on an issue that says what to do and which files it may touch. The Queen holds every open issue to judge() of specs/policy/issue_shape.t27. One that is not ready she shapes: a model writes the missing sections, and the body goes back only if judge() then finds nothing missing. After SHAPE_ATTEMPT_LIMIT, 2 failed shapes, she stops and comments once with what is missing, and an epic is never shaped. shape_action in shaping.t27 decides, and a new try waits 360 minutes.

Try it

Set two sections missing and step through the tries; then mark the author told and see which column the issue goes to.

+
Shaping: what the Queen does with an issue that is not readyThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/shaping.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

A boundary of real files

+
+

You will learnWhich proposed paths a task may reserve, and why one invented path stops the whole shape.

A task's boundary is a reservation: while a bee works, no other bee takes those files. So a wrong boundary is worse than a missing one, because it holds files the work does not own. path_accepted takes any file that exists, and a new file only when its folder exists, the issue cites it, and its language is one the only-t27 rule allows. shape_lands writes the shape back only when no section is missing, it names 1 to 12 paths, and none of them was refused.

Try it

Make the two red paths green by changing only facts that could be true; then leave a section missing and watch the gate.

+
A boundary: which files a task may reserveThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/shaping.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

One task, three kinds

+
+

You will learnHow an issue, a review and a job become one kind of task with seven states, and how one filter reads them.

The Queen runs three kinds of work: issues for bees, reviews of finished work, and jobs. Each kept its own codes, so no board could show them together. tasks.t27 gives them 7 shared states, numbered as the board's columns plus failed. A cancelled job shows as dropped, and so does a review row that was forgotten. task_matches is the filter the board, the game and the route all apply: a bit per kind, a bit per state, and 0 means any.

Try it

Show only failed tasks of every kind; then find which job state shows as dropped.

+
One task, three kinds: the filter the board and the game shareThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/tasks.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · Who goes next

The order the Queen takes issues in: a label ages one step, at most 3 criticals run as critical, and nothing new starts while finished work waits for review.

+
+
04

Lesson 4 of 27

Aging a label

+
+

You will learnHow a labelled issue moves up with age, and why only by one level.

Without labels the Queen takes issues in GitHub's listing order. priority.t27 adds four levels, critical, high, normal and low; lower runs first, and an unlabelled issue counts as normal. A labelled issue gains one level after AGING_DAYS, 14 days, and at most MAX_AGING_STEPS, 1 level, so a low issue reaches normal on day 14 and stays there. High and critical do not age. effective_level computes the line the widget draws.

Try it

Find the day a labelled low issue moves up; then remove the label and drag to day 60.

+
Aging: how long a labelled low issue waitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/priority.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

The queue

+
+

You will learnHow the cap, aging and blockers order a queue of open issues.

Labels inflate: if every issue is critical, none is. capped_level lets at most CRITICAL_CAP, 3, issues of a listing run as critical, taken in listing order, and the 4th runs as high. An issue with an open blocker is skipped, not waited on, so it cannot hold up the queue. outranks compares the effective level, then the real level, then the place in the listing, so an aged issue never beats a real one of its level. why names the reason for each place.

Try it

Make a fifth issue critical and see where it lands; then label the unlabelled issue low.

+
The queue: which issue the Queen takes firstThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/priority.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

Review first

+
+

You will learnWhy the Queen closes the backlog while finished work waits for a review, and what still goes.

On 2026-10-18 the status page read 69 of 70 workers busy, and in one hour 102 dispatches, 56 finished and 11 reviewed. Bees started about nine for every verdict, and each new bee held files that the bees in review needed when they were sent back. review_first.t27 closes the backlog while the review queue is longer than REVIEW_QUEUE_MAX, 0. Work the review sent back and work the owner assigned still go: admission admits them at any queue length.

Try it

Drag the queue to 0 and back to 1; then find the candidates that are admitted at any length.

+
Review first: no new work while finished work waitsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/review_first.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · A bee's life

From candidate to done: twelve states and sixteen events, a ship in the game that flies home, and a deploy that does not cut a bee short.

+
+
07

Lesson 7 of 27

A task's life

+
+

You will learnWhich states a dispatched task passes through, and which events are legal in each.

dispatch.t27 is the Queen's task lifecycle, the cycle that chooses, starts, ends, reviews and releases work. A task has 12 states and 16 events. next_state answers every pair, and 99 means the event is illegal in that state: a verdict cannot reach a running task, and a reap cannot reach an ended one. After a verdict a send-back waits for its floor and is released; even an accept is sent back if CI turns red under the ceiling.

Try it

Walk a task from none to accept; then make CI red at the ceiling and find the one way out.

+
A task's life: the Queen's state machineThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/dispatch.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

The ship flies home

+
+

You will learnWhere the game draws a bee for each thing it is doing, and how a finished task ends on screen.

In the game at app.t27.ai/game each bee is a ship over the issue it works on. ship_mode in hive.t27 picks the place: parked at the entrance before a runner claims it, orbiting its cell while it is heard from, hovering when it has gone quiet, and waiting at its repository's portal until its cell is placed. When the bee leaves the feed it flies home, and ship_alpha fades it over DEPART_MS, 2400 ms: at 1200 ms it is at 500 of 1000.

Try it

Mark the bee as not heard from and see where it moves; then drag the time past 2400 ms.

+
The game: where a bee flies and how it leavesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/hive.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

A deploy mid-flight

+
+

You will learnWhat a redeploy does to a bee, a review, a round, a job and a wait.

Every merge redeploys the Queen, and work is running when it does. drain.t27 sorts that work. A round, a job step and a wait row are rows the store keeps: the process leaves them and the next process carries on. A review is stopped, because a stop loses at most one review, which is redone. A bee is held, because what it has done lives in its conversation; at the cap, drain_cap_seconds, 1800 s today, it is handed back and its work is salvaged into its branch.

Try it

Drag the wait from 0 to the cap and watch the bee's row change; then cut the platform drain to 1000 s.

+
A deploy mid-flight: what happens to a running beeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/drain.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · The reviewer bee

Finished work is judged on its own clock: enough reviews at once to keep up, a pause that doubles for a row that waits, and a merge gate that zero checks cannot open.

+
+
10

Lesson 10 of 27

Enough reviewers

+
+

You will learnHow many reviews must run at once for the reviewer to keep up with the bees.

A review may take REVIEW_ROW_SECONDS, 300 s, so one slot clears at most 12 rows an hour. On 2026-10-09 bees finished about 58 an hour while 111 rows waited, and the fixed REVIEWER_CONCURRENCY of 4 tops out at 48. slots_needed(58) is 5. reviewer_concurrency takes the keys, their lanes and the free memory, never goes above 16 and never below 1 while anything waits, and keeps_up compares it with the finish rate.

Try it

Find the fewest keys of 1 lane that keep up with 58 an hour; then cut the memory to 1000 MB.

+
How many reviewer bees: keeping up with the finish rateThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/reviewer.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

Back off

+
+

You will learnWhy a row that answers wait is visited less and less often, and how often at least.

Over 44 minutes on 2026-10-09 the reviewer made 941 row visits, 888 of them wait, from 22 rows whose branch it could not read; one row was visited 54 times. revisit_after_seconds now waits 30 s after one wait and doubles per wait, never past 900 s: 30, 60, 120, 240, 480, 900. due_again lets the row be taken only once that time has passed, and any other answer resets the count.

Try it

Find the wait count where the pause stops growing; then set 4 waits and find the second the row is due.

+
Back off: when the reviewer looks at a waiting row againThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/reviewer.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

The merge gate

+
+

You will learnWhen the merger may merge a pull request a reviewer bee approved.

The reviewer bee approves, and the merger merges; merger_gate.t27 is the rule between them. check_passes lets a green check through and blocks any check still running. A red one passes only when it is not required, has concluded, and the bee named it as discounted, and with the ruleset unreadable every check counts as required. gate_open needs at least 1 posted check, 0 running and 0 blocking: zero checks is not zero failures.

Try it

Let the running check conclude green; then make the ruleset unreadable and watch the discounted red.

+
The merge gate: when an approved pull request may mergeThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/merger_gate.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · The review jam

A pull request that will not move is in exactly one of ten cases, each with the Queen's move, and a red check is inherited only when master says so.

+
+
13

Lesson 13 of 27

The review jam

+
+

You will learnWhich of ten cases a stuck pull request is in, and why the earliest matching rule wins.

A pull request can stall for many reasons at once: refused, pushed again, and red on a noise check. review-jam.t27 gives the Queen one answer. jam_case checks 9 facts in a fixed order and the earliest rule that matches wins, so a PR the Queen could not measure is never reported as free, and one that was refused and then pushed is not taken for noise. There are 10 cases, from none to unmeasured.

Try it

Clear facts one by one from the start state and name each case you pass; then find a PR that is in no jam.

+
The review jam: which case a stuck pull request is inThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/review-jam.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

The Queen's move

+
+

You will learnWhat the Queen does for each jam, and which jams she waits on.

Each case has one action at the same position: no reviewer dispatches a reviewer, refused not fixed dispatches the coder, refused then pushed dispatches a re-review, and labeled not merged finishes the merge. jam_action maps any value above 9 to measure again, so an unknown case is never nothing to do. jam_is_queens_turn is false for 3 cases, none, draft or fresh, and stacked on an open PR: she waits on those.

Try it

Find the case whose action is wait for the base; then drag to 200 and read the action.

+
The Queen's move: what each jam asks of herThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/review-jam.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

Inherited red

+
+

You will learnWhen a red check on a pull request is inherited from master, and why a cancelled run says nothing.

A bee may approve a PR with a red check when that check is red on master too. On 2026-10-06 a PR merged red because master's run of that check was cancelled and was read as red. Now the merger reads master itself, newest run first: run_says counts only a completed failure or success, look_back passes over everything else and over runs older than the merge base, and discount_holds needs the bee's word and MASTER RED.

Try it

Make every run cancelled; then move the failure before the merge base and look at the gate.

+
Inherited red: what master's runs say about a red checkThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/merger_gate.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · Keys

A bee's model key can be refused: the code in the body sorts the refusal, a transient one rests the key for seconds, and the bee moves on to the next free key.

+
+
16

Lesson 16 of 27

A refused key

+
+

You will learnHow the Queen sorts a provider's refusal into transient, quota, auth or a bad request.

Bees call models with keys, and keys get refused. key_failover.t27 sorts each refusal with error_kind. The z.ai code in the body wins over the HTTP status, because z.ai sends a spent quota and a passing overload with the same 429: code 1305 is transient, 1113 is quota. No answer at all is transient. A quota or auth refusal closes the key, and only a bad request is charged to the issue.

Try it

Compare 429 with codes 1308 and 1312; then read what no answer at all is.

+
A refused key: transient, quota, auth or a bad requestThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/key_failover.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

A key rests

+
+

You will learnHow long a refused key rests before a bee may use it again.

A transient refusal rests the key COOL_BASE_SECONDS, 15 s, doubled per strike in a row and never more than COOL_CAP_SECONDS, 240 s: 15, 30, 60, 120, 240. A spent quota or a refused key closes it for KEY_BREAK_SECONDS, 1800 s. cooldown_seconds gives all of it. The rest is short so that 34 keys are never all resting through a one-minute burst like the one of 2026-10-17.

Try it

Find the strike count where the rest stops growing; then switch to quota and read the rest.

+
How long a refused key restsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/key_failover.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

The next key

+
+

You will learnWhich key a bee tries next, and when it moves to another pool or gives up.

On 2026-10-17 a bee started on key 9 of 10 and died 7 s later while 33 other keys stood by: it got one key at dispatch and kept it. next_free now picks the next key after the last one that is neither tried nor resting. 1305 is an overload of the pool's model, so once POOL_OVERLOAD_KEYS, 3, keys said it within a minute, step moves the bee to the next pool. After 8 attempts the turn ends.

Try it

Mark key 2 as tried and see which key gets the ring; then set three keys that said 1305.

+
The next key: a bee moves on instead of dyingThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/key_failover.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · Credit and money

Lending a key earns no credit, an operation is sold at twice its cost in half-cent tokens, and tokens burn 30 days after they land.

+
+
19

Lesson 19 of 27

No credit for keys

+
+

You will learnWhat a contributor's lent keys earn, and which limits keep them safe.

Anyone can lend the hive model keys through queen-contributor-keys.t27. A key is probed before it is enabled: at most 4 probes at once, a new probe waits out 60 s after the last, and an owner holds at most 100 keys. Lending earns nothing by itself: CREDIT_WALLET is false, so wallet_credit answers 0 for any number of keys. XP follows the work the Queen records.

Try it

Drag the keys from 0 to 100 and watch the credit meter; then find the second a probe may start.

+
Lending a key earns no credit: XP follows recorded workThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/queen-contributor-keys.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

Twice the cost

+
+

You will learnHow the project prices an operation and what a month of tokens buys.

Every dollar becomes tokens at one rate, TOKEN_MICRO_USD 5000: a token is half a cent. price_tokens sells an operation at twice what it costs, MARKUP_PCT 200, and rounds up so nothing sells below that: a cost of 12300 micro-dollars is 5 tokens. month_tokens turns $20 into 4000 tokens, which is 14 reels of 270 tokens or 333 portraits of 12.

Try it

Find the costs that give exactly 1 token; then find the monthly price that buys 36 reels.

+
The price of an operation: twice its cost, rounded upThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/token-wallet.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

Tokens that burn

+
+

You will learnWhen a batch of tokens burns, and which batch is spent first.

The owner's rule of 2026-10-01: all money goes into tokens, and tokens not spent within the month burn, so a person who paid makes content instead of saving tokens. Each batch lives MONTH_DAYS, 30 days, and days_left counts it down from the day it landed. On day 25 the package month from day 0 has 5 days left, the start gift from day 3 has 8, and a top-up from day 12 has 17. The spend order is soonest burn first.

Try it

Find the day the package month burns; then find the last day any batch is left.

+
Tokens that burn: a month to spend themThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/token-wallet.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · Agents among themselves

One bot per agent in one group: who is called, a chain three bot messages deep, and the clocks that keep agents from flooding a chat.

+
+
22

Lesson 22 of 27

Who is called

+
+

You will learnWhich messages in the hive group wake an agent, from a person and from another agent's bot.

Every agent has its own bot and its own topic in one forum group. A person calls an agent by its tag, by @all, by a reply, or by writing in its topic. Another agent's bot calls it only by a tag or a reply: a bot never triggers the whole hive and never wakes a topic's owner by merely writing there. addressed in agent-hive-group.t27 is that rule, one line long.

Try it

Find the two ways only a person can call an agent; then turn on all four and compare the senders.

+
Who is called: an agent bot in a group of agentsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/agent-hive-group.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

Three bots deep

+
+

You will learnHow the hive stops agents from answering each other forever.

Telegram gives no loop protection between bots, so two agents could answer each other forever. Two numbers stop it. MAX_BOT_DEPTH is 3: a person, then A, B and C, then silence. BOT_REPLY_COOLDOWN_MS is 5000: a bot answers another bot at most once in 5 s. may_answer always lets a person through, and a bot only inside the chain and after the cooldown.

Try it

Find the gap at which agent B falls silent; then explain why C is silent too.

+
Chain depth: human, A, B, C, then silenceThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/agent-hive-group.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

Stop and mute

+
+

You will learnWhat /stop and /mute do, and why neither can lose a person or a direct call.

cooled says whether 5000 ms have passed since the last bot message. /stop silences bot-to-bot turns in a chat for STOP_WINDOW_MS, 10 minutes, and a person is still heard: that is may_answer_after_stop. /mute keeps an agent quiet in a topic for MUTE_MS, an hour, but it still answers its own tag: heard_while_muted. Both are clocks, so nobody has to switch the hive back on.

Try it

Drag the /stop clock past 10 minutes; then tag the muted agent.

+
The cooldown clock, /stop and /muteThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/agent-hive-group.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · Night and the board

What the hive shows: a night watch that opens, comments on and closes issues, the columns of the public board, and the comb that flashes for each event.

+
+
25

Lesson 25 of 27

The night watch

+
+

You will learnWhat the night watch does in the morning with four card checks.

Every night four checks of the card chat run: the thread, the status door, the merges and the parity. night_verdict sums them up: any fail is a fail, else anything unmeasured is unmeasured, else it is a pass. night_report turns that into one act: a fail opens an issue or comments on the open one, a pass closes an open issue or stays silent, and an unmeasured night leaves everything as it is.

Try it

Make the night pass with the issue open; then make one check unmeasured.

+
The night watch: four checks, one verdict, one reportThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/automation/card-chat-night-watch.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

The public board

+
+

You will learnWhich column the public board draws each claim in, and the case it gets wrong.

The board at app.t27.ai/game/kanban draws every dispatch in one of 6 columns. column_of reads the claim a dispatch holds on its issue: running is running, accepted is done, rejected and awaiting review are in review, and failed is dropped. dispatch.t27 records one finding as it is: once an issue is closed and the list was read, every finished claim is drawn as done, whatever its verdict.

Try it

Open the issue and see where the four finished claims go; then say what a closed issue hides.

+
The public board: which column a task's card is inThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/dispatch.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

The comb answers

+
+

You will learnHow the game shows that something happened to a task, and how often the map grows.

The game's comb has a cell for each issue, and before hive.t27 an accepted task, a lost lease and a cancel looked the same as no news. cell_effect gives each of the 10 event kinds its paint: a start white, an accepting review gold, a send-back amber, a lost lease red, a cancel grey. flash_alpha fades it over FLASH_MS, 1800 ms. A new cell rebuilds the scene, so cells_due places new cells in batches at most every 300 s.

Try it

Tap the review cell and switch the verdict; then find the moment the flash is gone.

+
The comb answers: what an event does to a cellThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/queen/hive.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · The task
    1. 01 Shaping an issue
    2. 02 A boundary of real files
    3. 03 One task, three kinds
  2. 02 · Who goes next
    1. 04 Aging a label
    2. 05 The queue
    3. 06 Review first
  3. 03 · A bee's life
    1. 07 A task's life
    2. 08 The ship flies home
    3. 09 A deploy mid-flight
  4. 04 · The reviewer bee
    1. 10 Enough reviewers
    2. 11 Back off
    3. 12 The merge gate
  5. 05 · The review jam
    1. 13 The review jam
    2. 14 The Queen's move
    3. 15 Inherited red
  6. 06 · Keys
    1. 16 A refused key
    2. 17 A key rests
    3. 18 The next key
  7. 07 · Credit and money
    1. 19 No credit for keys
    2. 20 Twice the cost
    3. 21 Tokens that burn
  8. 08 · Agents among themselves
    1. 22 Who is called
    2. 23 Three bots deep
    3. 24 Stop and mute
  9. 09 · Night and the board
    1. 25 The night watch
    2. 26 The public board
    3. 27 The comb answers
+ + + + + diff --git a/apps/website/public/learn/queen-and-hive/index.html b/apps/website/public/learn/queen-and-hive/index.html index 5f7b37277b..105707c0b2 100644 --- a/apps/website/public/learn/queen-and-hive/index.html +++ b/apps/website/public/learn/queen-and-hive/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

The Queen and the hive: how the t27 project builds itself

This project builds itself: an issue becomes a task for a bee, the bee writes a t27 spec, a reviewer bee checks it, it merges, and the site regenerates. The Queen who runs that loop is written as t27 specs with tests, and every widget here runs the fn bodies of one of them compiled to WebAssembly.

Course 11, 27 lessons, a live widget and a t27 spec each: shaping an issue, priority and review first, a task's life, the reviewer and the merge gate, the review jam, keys, credit and tokens, agents in one group, the night watch and the board. Every answer comes from a compiled spec.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/questions-in-thirds/index.html b/apps/website/public/learn/questions-in-thirds/index.html index 7af9bdcd56..446e1f7113 100644 --- a/apps/website/public/learn/questions-in-thirds/index.html +++ b/apps/website/public/learn/questions-in-thirds/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Questions in thirds

You will learn

Why three-answer questions find a number faster, and spell it as they go.

Ask which third of the range a hidden number lies in, and each answer is one of three: low, middle, high. Over the range -121..121 the answers, from the top, are exactly the number's five trits. Among 243 numbers that takes 5 questions; yes-or-no questions need 8. The spec's questions3() and questions2() count both.

Try it

Hide 23 and ask until it is found; then hide -121 and say what every answer was.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Twenty questions in thirds
Twenty questions in thirds ↗

Hide a number. Each question asks which third it lies in; the answers are its trits, top first. 243 numbers take 5 questions instead of 8.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Questions in thirds

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/read-a-bitstream/index.html b/apps/website/public/learn/read-a-bitstream/index.html index 94adcff60b..22072b84b2 100644 --- a/apps/website/public/learn/read-a-bitstream/index.html +++ b/apps/website/public/learn/read-a-bitstream/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Read a bitstream

You will learn

What is inside a .bit file, and which chip it was built for.

A .bit file is a header followed by packets: commands to the chip's configuration logic and the frames themselves. One of those commands writes the IDCODE of the chip the file was built for. Drop a .bit into the autopsy and see which chip it asks for. Five bitstreams committed to t27 turn out to target a different part than our bench.

Try it

Open the blink_j26 sample and compare the part in its header with the IDCODE it writes. In the spec frame, read HELP_LINE: against which reference tool is tri x7-writer byte-identical, and what kind of input does it refuse?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Bitstream autopsy: which FPGA a 7-series .bit really targets
Bitstream autopsy: which FPGA a 7-series .bit really targets ↗

Drop a Xilinx 7-series .bit: header, the IDCODE it writes and the part that names, frames, zero bytes and packets, read in your browser. Nothing is uploaded.

specs/tools/trios/tri/x7-writer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Read a bitstream

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/reading-errors/index.html b/apps/website/public/learn/reading-errors/index.html index e8a77f30a0..8f28e96614 100644 --- a/apps/website/public/learn/reading-errors/index.html +++ b/apps/website/public/learn/reading-errors/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Reading compiler errors

You will learn

How to read the line and column of an error, using four real mistakes.

A parse error says where the parser was, near which line, and the token it did not expect, with a line and a column. A type error names the constant and why its value does not fit. Read the position first, then look one token to the left: the mistake is often just before the place the parser stopped. The table shows what the compiler on this site answered for four small mistakes.

Try it

Make each of the four mistakes in the player and match the line and column with the table.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 25: four mistakes and what t27c says
t27 basics 25: four mistakes and what t27c says ↗

Four small mistakes in a t27 spec and the exact message the real compiler printed for each. Lesson 25 of the t27 basics course.

specs/basics/25_reading_errors.t27

// SPDX-License-Identifier: Apache-2.0
@@ -79,6 +111,7 @@ 

Reading compiler errors

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/related-or-not/index.html b/apps/website/public/learn/related-or-not/index.html index de4bcdc9bc..b6a07586a8 100644 --- a/apps/website/public/learn/related-or-not/index.html +++ b/apps/website/public/learn/related-or-not/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Related or not

You will learn

When the analyzer checks a path between two clocks and when it must be told they are strangers.

Two clocks are related when one is made from the other -- through the MMCM of module 3 -- and then every path between them is timed: the analyzer knows they share an origin. Strangers get no such path check unless you declare one. timing.t27 is the arithmetic of that check: timing arcs, slack and Fmax with an Artix-7 teaching model, LUT 0.1 ns, BRAM 2.0 ns, DSP 2.5 ns, routing 0.3 ns. The recording runs the native t27c: 25 tests pass, 2 invariants comptime. Related clocks were module 3; making strangers safe is modules 5 to 7.

Try it

In the recording, count the passing tests; then in the spec frame find the four teaching delays of the header and the function that turns arcs into slack.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on timing.t27 -- static timing, native
t27c on timing.t27 -- static timing, native ↗

t27c 0.4.0 on a laptop (macOS): 25 tests of the timing spec pass natively, 2 invariants comptime -- arcs, slack, Fmax and the Artix-7 teaching delays (LUT 0.1 ns, BRAM 2.0 ns, DSP 2.5 ns).

specs/fpga/timing.t27

// SPDX-License-Identifier: Apache-2.0
@@ -446,6 +478,7 @@ 

Related or not

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/relu/index.html b/apps/website/public/learn/relu/index.html index d122ccdb5f..b78f07d788 100644 --- a/apps/website/public/learn/relu/index.html +++ b/apps/website/public/learn/relu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

ReLU: keep the positive part

You will learn

What ReLU does to a positive and to a negative input, and why a slope of 0 stops a unit from learning.

A neuron adds up its weighted inputs and passes the sum through an activation. ReLU is the plainest one, max(0, x): a positive sum goes through unchanged and a negative one becomes 0. Its slope is 1 or 0, and a slope of 0 is a unit that has stopped learning, because no gradient flows back through it. A leaky slope fixes that: with a slope of 0.1, x = -2 gives -0.2 and passes back a gradient of 0.1. The spec relu_activation.t27 computes both curves the widget draws.

Try it

Put x at -2 and read the slope with and without the leak; then find the slope at x = 1.5.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

ReLU: what a neuron does with a negative number
ReLU: what a neuron does with a negative number ↗

Drag along the curve and watch ReLU pass every positive input and zero every negative one; give it a leaky slope and a little of the negative side gets through.

specs/ml/activation/relu_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -203,6 +235,7 @@ 

ReLU: keep the positive part

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/reset-fanout/index.html b/apps/website/public/learn/reset-fanout/index.html index e3b6698410..d95549896c 100644 --- a/apps/website/public/learn/reset-fanout/index.html +++ b/apps/website/public/learn/reset-fanout/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Reset fanout

You will learn

Why a reset grows a tree like a clock, and where its cost shows up in a real resource count.

A reset reaches every flop in the design, so it grows a tree like a clock tree and is balanced for the same reason: an uneven release is a skew you built yourself. The widget counts a real routed design against the XC7A200T's own totals, read from the chipdb and prjxray-db, and counts yours if you drop your routed JSON on it. A reset tree lives in the same budget: routing and control-set pressure, visible in exactly those bars. The spec frame opens cts.t27 once more, the tree arithmetic that both trees share.

Try it

In the widget, read the totals the bars are counted against; then in the spec frame find the skew target a reset tree is balanced to meet.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-rxcap
tri fpga-rxcap ↗

Per-bit setup and hold of an asynchronous RX nibble sampled by RXC, from the routed SDF: the four rxd bits of one nibble change 2387 to 2486 ps apart, so a binary counter tears where a gray one cannot.

specs/fpga/cts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -292,6 +324,7 @@ 

Reset fanout

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/reset-release/index.html b/apps/website/public/learn/reset-release/index.html index d9bbad0638..672ba3f41d 100644 --- a/apps/website/public/learn/reset-release/index.html +++ b/apps/website/public/learn/reset-release/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The release pipe

You will learn

How a reset release walks a shift register, and what the compiler emits for it.

The release walks a shift register: at the destination clock, flop after flop takes its neighbour's value, and the reset is held until the pipe runs dry. The latency is the stage count -- 2 stages release in 2 clocks, 3 in 3. The recording shows what the compiler emits for the model: t27c gen prints the Zig, and the step function is a struct copy, one field per flop, no more. The wc -l at the end of the recording is the size of the whole generated model.

Try it

In the recording, find the wc -l count; then in the spec frame find after_clocks() and check that release latency equals the stage count.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen on reset_sync.t27 -- the release pipe as Zig
t27c gen on reset_sync.t27 -- the release pipe as Zig ↗

t27c gen prints what it compiled: the step function is a Zig struct copy, one field per flop, and wc -l says how many lines the whole model took.

specs/fpga/reset_sync.t27

// SPDX-License-Identifier: Apache-2.0
@@ -327,6 +359,7 @@ 

The release pipe

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/review-first/index.html b/apps/website/public/learn/review-first/index.html index f22c5d6733..276995ba34 100644 --- a/apps/website/public/learn/review-first/index.html +++ b/apps/website/public/learn/review-first/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Review first

You will learn

Why the Queen closes the backlog while finished work waits for a review, and what still goes.

On 2026-10-18 the status page read 69 of 70 workers busy, and in one hour 102 dispatches, 56 finished and 11 reviewed. Bees started about nine for every verdict, and each new bee held files that the bees in review needed when they were sent back. review_first.t27 closes the backlog while the review queue is longer than REVIEW_QUEUE_MAX, 0. Work the review sent back and work the owner assigned still go: admission admits them at any queue length.

Try it

Drag the queue to 0 and back to 1; then find the candidates that are admitted at any length.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Review first: no new work while finished work waits
Review first: no new work while finished work waits ↗

Drag the review queue. While anything waits in review, a backlog issue is refused; work the review sent back and work the owner assigned still go.

specs/queen/review_first.t27

// SPDX-License-Identifier: Apache-2.0
@@ -243,6 +275,7 @@ 

Review first

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/rgmii-timing/index.html b/apps/website/public/learn/rgmii-timing/index.html index bcc681048f..b367ac49f9 100644 --- a/apps/website/public/learn/rgmii-timing/index.html +++ b/apps/website/public/learn/rgmii-timing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

RGMII timing

You will learn

What RGMII timing demands of a double-data-rate nibble, and what the spec asserts of it.

RGMII moves a nibble per clock edge, both edges: double data rate at 125 MHz for gigabit, and a single-data-rate downshift for 10 and 100. The spec of this lesson, written for this course, carries the timing arithmetic and its assumptions in the header. The recording runs t27c on it.

Try it

In the recording, watch the run; then in the spec frame find the DDR rate and what the spec says of the 10 and 100 downshift.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on rgmii.t27 -- RGMII timing, native
t27c on rgmii.t27 -- RGMII timing, native ↗

t27c test-report on the RGMII spec: 7 tests pass natively plus one comptime invariant -- the 8 ns gigabit period, a nibble on both edges, the 78 ps tap ladder.

specs/fpga/rgmii.t27

// SPDX-License-Identifier: Apache-2.0
@@ -184,6 +216,7 @@ 

RGMII timing

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/ripple-carry/index.html b/apps/website/public/learn/ripple-carry/index.html index 06ab7a2825..a6f17c6d1a 100644 --- a/apps/website/public/learn/ripple-carry/index.html +++ b/apps/website/public/learn/ripple-carry/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Ripple carry

You will learn

How a row of full adders adds two numbers, the carry walking left.

Line up full adders, one per place, and feed each carry into the next: a ripple-carry adder. 13 + 1 opens the widget: the ones place makes 2 = 3 - 1, so a carry of +1 walks through three places and +++ becomes +---. The spec's ripple_add() is checked against plain addition on 198 pairs. The lesson spec builds a 2-bit binary ripple adder from the same ternary parts.

Try it

Press play and stop at the column where the carry first turns back to 0; then try 40 + 41.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Ripple carry: add two numbers trit by trit
Ripple carry: add two numbers trit by trit ↗

Two numbers, one full adder per place, the carry walking left. Press play to watch every column decide its sum.

specs/ternary/ternary_ripple_adder.t27

module TernaryRippleAdder;
@@ -157,6 +189,7 @@ 

Ripple carry

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/rmsprop/index.html b/apps/website/public/learn/rmsprop/index.html index d926639ca5..495816a7a4 100644 --- a/apps/website/public/learn/rmsprop/index.html +++ b/apps/website/public/learn/rmsprop/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

RMSProp

You will learn

How RMSProp divides each step by a running root mean square, so the step no longer depends on the gradient's size.

The right step size depends on the size of the gradient, and different weights see gradients a million times apart. RMSProp keeps a running mean of the squared gradient, the cache, and divides each step by its root, so the step has no units: with a constant gradient of 0.001, 0.5 or 1000 the weight moves by exactly the same 0.0316 on step 1 and walks the same path, reaching -0.0914 after 100 steps at lr 0.01. The decay sets how slowly the cache fills: at 0.99 the same 100 steps end at -1.0261. The spec rmsprop.t27 computes the weight and the cache.

Try it

Switch between the three gradients and check that the lines do not move; then raise the decay to 0.99.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

RMSProp: a step that does not care how big the gradient is
RMSProp: a step that does not care how big the gradient is ↗

Feed one weight a constant gradient of 0.001, 0.5 or 1000: RMSProp divides by the root of its running mean square, so all three walk the same path. Change the decay and the path bends.

specs/ml/optimizer/rmsprop.t27

// SPDX-License-Identifier: Apache-2.0
@@ -167,6 +199,7 @@ 

RMSProp

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/rotating-by-shifts/index.html b/apps/website/public/learn/rotating-by-shifts/index.html index 07040c248c..a56bd1796f 100644 --- a/apps/website/public/learn/rotating-by-shifts/index.html +++ b/apps/website/public/learn/rotating-by-shifts/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Rotating by shifts

You will learn

How CORDIC rotation mode reaches cos and sin with nothing but shifts and adds.

Turn a vector by atan(2^-i), one way or the other, at step i: the multiply by tan is a shift by i, so each step is two shifts and two adds. Steering by the sign of the angle left drives that angle to zero, and starting at K(n) instead of 1 cancels the stretch each step adds; K(n) tends to 0.6072529350. After 16 steps, 30 degrees comes out as cos 0.866018 and sin 0.500013. The spec cordic.t27 computes every step the widget draws.

Try it

Run 30 degrees with 4 steps and then with 16, and read the errors; then find the step at which the direction first turns clockwise.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

CORDIC: rotate a vector with shifts and adds
CORDIC: rotate a vector with shifts and adds ↗

Set an angle and a number of steps and watch the vector turn by ever smaller angles, each one only a shift and an add, until it lands on cos and sin.

specs/fpga/dsp/cordic.t27

// SPDX-License-Identifier: Apache-2.0
@@ -437,6 +469,7 @@ 

Rotating by shifts

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/rounding-and-saturation/index.html b/apps/website/public/learn/rounding-and-saturation/index.html index cde008ead4..03f8f19fdc 100644 --- a/apps/website/public/learn/rounding-and-saturation/index.html +++ b/apps/website/public/learn/rounding-and-saturation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Rounding and saturation

You will learn

What truncation, rounding and convergent rounding do to a value and to its average, and when to wrap or saturate.

Dropping low bits is truncation, and truncation is biased: on a ramp its mean error is -0.25 LSB for one dropped bit and tends to -0.5 as more go. Round half up is biased the other way, +0.25 for one bit; convergent rounding sends ties to the even neighbour and averages to 0. Outside the range a two's complement adder wraps for free, turning 1.0 into -1.0 in Q1.15; saturation costs a comparator and keeps the sign. The spec fixed_point.t27 measures all three modes on a ramp.

Try it

Store 1.25 in Q3.1 with each rounding mode and note the stored value; then drop 4 bits and read the three biases.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Rounding and saturation: the error you choose, and its bias
Rounding and saturation: the error you choose, and its bias ↗

Drag a value into a small Qm.n and switch between truncation, rounding and convergent rounding, and between wrap and saturate. The bars show which rounding is biased.

specs/fpga/dsp/fixed_point.t27

// SPDX-License-Identifier: Apache-2.0
@@ -344,6 +376,7 @@ 

Rounding and saturation

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/run-a-program/index.html b/apps/website/public/learn/run-a-program/index.html index 1d42d4a3e4..a01aa014e0 100644 --- a/apps/website/public/learn/run-a-program/index.html +++ b/apps/website/public/learn/run-a-program/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Run a program

You will learn

How five instructions and one three-way jump make a loop that ends itself.

The widget's machine has three 9-trit registers and five instructions: SET, ADD, DEC, BR3 and HALT. Sum 1..n sets r1 to n, adds it into r0, decrements, and BR3 jumps back while r1 is positive; at 0 it falls through to HALT. For n = 5 it halts with r0 = 15. The lesson spec describes the .tbin container a TRI-27 program ships in, as the Trinity loader reads it.

Try it

Step the sum program clock by clock for n = 3; then run 7 x n for n = 12 and count the clocks.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Run a program on a ternary machine
Run a program on a ternary machine ↗

Two short programs on three 9-trit registers: sum 1..n and multiply by repeated adds. Step a clock at a time and watch the trits change.

specs/isa/tri27_bytecode.t27

// SPDX-License-Identifier: Apache-2.0
@@ -276,6 +308,7 @@ 

Run a program

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/same-bits-on-the-board/index.html b/apps/website/public/learn/same-bits-on-the-board/index.html index 6145cdac12..a10c16b800 100644 --- a/apps/website/public/learn/same-bits-on-the-board/index.html +++ b/apps/website/public/learn/same-bits-on-the-board/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The same bits, on the board

You will learn

How to show that a bitstream is byte-identical and that it runs.

The claim most FPGA people doubt: a bitstream built by an open flow from t27 specs, byte-identical to the reference toolchain, and working on a real board. This recording compares the files, loads the bits into the chip's SRAM and counts the receipts the board sends back. Drop two .bit files into bit-diff to check the byte-identical part yourself.

Try it

Wait for the receipts count at the end, then try bit-diff under Also try. In the spec frame, ACTIONS lists the steps of tri x7-board: which one loads the chip's SRAM, and which flag does HELP_LINE say it needs?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A bitstream from t27 specs, run on the AX7203
A bitstream from t27 specs, run on the AX7203 ↗

Byte-identical to openXC7's .bit, loaded into SRAM, 51,840 of 51,840 tagged receipts on the board.

specs/tools/trios/tri/x7-board.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

The same bits, on the board

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/same-neuron-new-weights/index.html b/apps/website/public/learn/same-neuron-new-weights/index.html index 09adcb10ad..9d40224e93 100644 --- a/apps/website/public/learn/same-neuron-new-weights/index.html +++ b/apps/website/public/learn/same-neuron-new-weights/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Same neuron, new weights

You will learn

How one ternary neuron computes a majority vote with one set of weights and a different function with another.

maj3 in bitnet_majority.t27 packs three trits with pack3, takes dot27 against w_all_p, an all-P weight chunk, and quantizes at 0: the result is the sign of a + b + c. weighted_vote is the same neuron with weights pack3(2, 2, 0) and gives the sign of a + b - c, so the weights pick the function. The browser skips all 12 tests because it does not know assert_eq yet; the native t27c runs all 12, all pass, none vacuous. The recording lowers w_all_p by 16, which turns the weight on lane 2 from P to Z, so maj3 no longer sees c. Exactly one test fails, maj_p_n_n: +1 - 1 - 1 is N, but +1 - 1 is Z. Note that wv_p_z_p passes 0, which is N, as its middle input. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the expected and the actual value of maj_p_n_n; then in the spec frame find wv_p_z_p and work out what weighted_vote(2, 1, 2) would return.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on bitnet_majority.t27 -- One neuron, two functions, native
t27c on bitnet_majority.t27 -- One neuron, two functions, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 12 tests pass natively; one maj3 weight moved from P to Z fails exactly one test, maj_p_n_n; git restores the spec.

specs/ternary/bitnet_majority.t27

module BitnetMajority;
@@ -133,6 +165,7 @@ 

Same neuron, new weights

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/sampling-and-aliasing/index.html b/apps/website/public/learn/sampling-and-aliasing/index.html index af750d2ea3..ef3d8a9b3a 100644 --- a/apps/website/public/learn/sampling-and-aliasing/index.html +++ b/apps/website/public/learn/sampling-and-aliasing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Sampling and aliasing

You will learn

Why a tone above half the sample rate comes back as a lower one, and which way it folds.

A sampler sees a tone at f as one at |f - fs round(f/fs)|: the spectrum folds like paper at every multiple of fs/2. Sampled at 100, a tone at 70 is seen at 30, and so is one at 130. In every other Nyquist zone the fold runs backwards and the alias comes out mirrored. The time view shows why nothing after the sampler can tell: the samples of the 70 tone lie exactly on a 30 tone. The spec signals.t27 computes the fold, the zone and every point drawn.

Try it

Find three input frequencies that land on 30 at a rate of 100; then move fs and watch the corners of the triangle move.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Sampling and aliasing: the fold of every frequency
Sampling and aliasing: the fold of every frequency ↗

Set a tone and a sample rate: the tone folds back into 0 .. fs/2 like paper, and below, its samples fit a lower tone exactly.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Sampling and aliasing

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/scale-byte-native/index.html b/apps/website/public/learn/scale-byte-native/index.html index e206cb9612..0ae4bba258 100644 --- a/apps/website/public/learn/scale-byte-native/index.html +++ b/apps/website/public/learn/scale-byte-native/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The scale byte on a real machine

You will learn

What the native compiler checks in the same spec, including what the browser skipped.

The player in the last lesson could not run every check in e8m0.t27, and it said so. This recording runs the native t27c and Zig on a real machine on the same spec: its constants, the test report, the Zig tests, and the Verilog for the NaN check. Some checks are invariants the compiler proves while it compiles, so compiling is the check. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find how many invariants the test report proved at compile time, and compare its pass count with the player's.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on e8m0.t27 -- the MX shared scale byte, native
t27c on e8m0.t27 -- the MX shared scale byte, native ↗

t27c 0.4.0 and zig 0.16.0 on the t27c lab (Railway): the E8M0 scale byte of OCP MX, 18 tests and 9 comptime invariants pass, and the Verilog backend's NaN check.

specs/numeric/e8m0.t27

// SPDX-License-Identifier: Apache-2.0
@@ -334,6 +366,7 @@ 

The scale byte on a real machine

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/self-checking/index.html b/apps/website/public/learn/self-checking/index.html index bde21194c9..0b197d5294 100644 --- a/apps/website/public/learn/self-checking/index.html +++ b/apps/website/public/learn/self-checking/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Self-checking, not staring

You will learn

How to write a testbench that fails loudly, and why eyeballing waves is not a check.

A testbench that prints waves and stops is a machine for producing staring. A self-checking one computes a verdict and exits nonzero when it fails, so a script can run a thousand of them and trust the exit code. The widget is the terminal for seven t27 backends: every command run on hello_world, 21 pass, 0 fail -- every pass earned by an assert that executed, not by finishing. The lesson's spec, spi_tb, ends the same way: a count of checks, and a failure mode that cannot be mistaken for success.

Try it

Open the seven-backend terminal and find one command whose pass ran zero asserts; then check spi_tb for a failure mode that cannot print 'ok'.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 play · the terminal's own gates
t27 play · the terminal's own gates ↗

The terminal for seven t27 backends: every command run on hello_world. 21 pass, 0 fail.

specs/fpga/testbench/spi_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Self-checking, not staring

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/setup-hold-window/index.html b/apps/website/public/learn/setup-hold-window/index.html index 4ccbf90202..ea46b1ced3 100644 --- a/apps/website/public/learn/setup-hold-window/index.html +++ b/apps/website/public/learn/setup-hold-window/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The setup-hold window

You will learn

What setup and hold mean, what a flop does when the window is missed, and what a VCD shows of it.

Every flop has a window around its sampling edge -- setup before it, hold after it. Land a transition inside the window and the flop does not cleanly pick a level: its output can hang between 0 and 1, a metastable state that resolves at a time the datasheet does not promise. The widget reads a .vcd from any simulator and reports value changes, the busiest net, and signals stuck at X or Z: X in a simulation is the testbench's way of showing the window was missed. The spec frame opens clock_domain.t27, whose crossing model is what module 5 turns into arithmetic.

Try it

In the widget, drop a .vcd if you have one and find the busiest net; then in the spec frame find the crossing model the window belongs to.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-rxer
tri fpga-rxer ↗

RX_ER pulses injected at exact nibble positions of a ping -- preamble, mid-frame, IP header -- and the frame state each pulse leaves behind, RTL vs model.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

The setup-hold window

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/seven-backends-and-t27b/index.html b/apps/website/public/learn/seven-backends-and-t27b/index.html index 76614bf735..72f5c0015c 100644 --- a/apps/website/public/learn/seven-backends-and-t27b/index.html +++ b/apps/website/public/learn/seven-backends-and-t27b/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Seven backends, and t27b

You will learn

One spec, many target languages, and a native compiler with no LLVM.

One t27 spec can become Zig, C, Rust, JavaScript, TypeScript or Verilog; Verilog comes two ways, straight from the spec and through the HIR, which makes seven backends. The player shows the Rust t27c writes for hello_world. t27b is a second compiler: native AArch64 machine code, no LLVM, a JIT for tests and Mach-O object files. It is not finished, and we say how far it is: in run 26c447ad8 it passed 307 of the 449 specs that the reference compiler passes with tests, 68.4%.

Try it

Switch the player to JavaScript under Also try, generate the module, and run it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

hello_world.t27 to Rust, in a terminal inside the post
hello_world.t27 to Rust, in a terminal inside the post ↗

A terminal in your browser running the t27 compiler as WebAssembly: t27c gen rust prints the Rust it emits for hello_world.t27, and t27c test runs the spec's tests.

specs/tutorial/08_modules_and_arrays.t27

// SPDX-License-Identifier: Apache-2.0
@@ -157,6 +189,7 @@ 

Seven backends, and t27b

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/seven-backends/index.html b/apps/website/public/learn/seven-backends/index.html index 1166effae0..cdf87869a2 100644 --- a/apps/website/public/learn/seven-backends/index.html +++ b/apps/website/public/learn/seven-backends/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Seven backends

You will learn

The names of the 7 backends and how much code each wrote for one small spec.

The compiler in your browser has 7 backends: c, js, rust, ts, verilog, verilog_hir and zig. Each reads the same parsed spec and writes code in its language; the verilog_hir backend is written from the hardware view, HIR. The table shows the bytes each backend wrote for the lesson spec, measured with the compiler on this site. Bigger is not better: each language needs a different amount of text.

Try it

Open each backend tab of the lesson spec in the player and find the function add.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 22: one spec, seven backends
t27 basics 22: one spec, seven backends ↗

How many bytes each of the 7 t27c backends wrote for one small spec, measured with the real compiler. Lesson 22 of the t27 basics course.

specs/basics/22_seven_backends.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

Seven backends

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/shaping-an-issue/index.html b/apps/website/public/learn/shaping-an-issue/index.html index db07b230fd..10bd96231d 100644 --- a/apps/website/public/learn/shaping-an-issue/index.html +++ b/apps/website/public/learn/shaping-an-issue/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Shaping an issue

You will learn

What the Queen does with an issue that lacks sections, and why she stops after two tries.

A bee can start only on an issue that says what to do and which files it may touch. The Queen holds every open issue to judge() of specs/policy/issue_shape.t27. One that is not ready she shapes: a model writes the missing sections, and the body goes back only if judge() then finds nothing missing. After SHAPE_ATTEMPT_LIMIT, 2 failed shapes, she stops and comments once with what is missing, and an epic is never shaped. shape_action in shaping.t27 decides, and a new try waits 360 minutes.

Try it

Set two sections missing and step through the tries; then mark the author told and see which column the issue goes to.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Shaping: what the Queen does with an issue that is not ready
Shaping: what the Queen does with an issue that is not ready ↗

Set how many sections an issue lacks and how often shaping failed: the Queen leaves it, shapes it, or tells its author once what is missing.

specs/queen/shaping.t27

// SPDX-License-Identifier: Apache-2.0
@@ -198,6 +230,7 @@ 

Shaping an issue

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/shift-and-add/index.html b/apps/website/public/learn/shift-and-add/index.html index 1b4d10f6fb..d351f9c831 100644 --- a/apps/website/public/learn/shift-and-add/index.html +++ b/apps/website/public/learn/shift-and-add/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Shift and add

You will learn

Why a multiplier is a pile of shifted partial products, and how many of them a number costs.

Every 1 bit of the multiplier adds a copy of the multiplicand shifted by that bit's position; every 0 bit adds nothing. 200 x 13 is 200 + 800 + 1600 = 2600, three rows out of eight. Two 8-bit numbers make at most a 16-bit product, and an array multiplier is exactly this grid of AND gates feeding the carry-save trees of the last lesson. The spec multipliers.t27 computes each row and the running sum the widget draws.

Try it

Step through 200 x 13 row by row; then find a multiplier b from 0 to 255 that makes all eight rows add, and one that makes only one.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Shift and add: a multiplier is a pile of shifted copies
Shift and add: a multiplier is a pile of shifted copies ↗

Pick two 8-bit numbers and step through the partial products: one shifted copy of a for each 1 bit of b, summed row by row into the product.

specs/fpga/dsp/multipliers.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

Shift and add

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/simulator-internals/index.html b/apps/website/public/learn/simulator-internals/index.html index ee26a2af53..14769b0ec1 100644 --- a/apps/website/public/learn/simulator-internals/index.html +++ b/apps/website/public/learn/simulator-internals/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Inside the simulator

You will learn

What a simulator keeps (state) and what it does not (time between events).

A simulator is state plus a queue of things that happen, and knowing that is what makes its output trustworthy. The lesson's spec, simulator, models the engine itself: states, probe points, trace entries, and the loop that drains events in order. The widget reads the real bench the way a simulator holds state: cables, boards, locks, and the last board runs -- three x7-board runs PASS 51840/51840 -- one command, one snapshot, no narratives between.

Try it

In simulator.t27 find the loop that drains events and say what it would do if two events shared a timestamp; then compare with the status widget's one-snapshot read.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-status · the bench at a glance
tri fpga-status · the bench at a glance ↗

One command reads the bench: CP2102N UART direct on USB (no hub in the path), Digilent JTAG present, openocd not running, lock free, and the last board runs: three x7-board runs PASS 51840/51840.

specs/fpga/simulator.t27

// SPDX-License-Identifier: Apache-2.0
@@ -382,6 +414,7 @@ 

Inside the simulator

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/sitemap.xml b/apps/website/public/learn/sitemap.xml index 574263dae4..aad0701d77 100644 --- a/apps/website/public/learn/sitemap.xml +++ b/apps/website/public/learn/sitemap.xml @@ -29,6 +29,7 @@ https://t27.ai/learn/reading-errors/ https://t27.ai/learn/a-small-program/ https://t27.ai/learn/where-next/ + https://t27.ai/learn/all/ https://t27.ai/ru/learn/ https://t27.ai/ru/learn/what-a-spec-is/ https://t27.ai/ru/learn/the-module-line/ @@ -57,6 +58,7 @@ https://t27.ai/ru/learn/reading-errors/ https://t27.ai/ru/learn/a-small-program/ https://t27.ai/ru/learn/where-next/ + https://t27.ai/ru/learn/all/ https://t27.ai/learn/course/ https://t27.ai/learn/fpga-is-a-grid/ https://t27.ai/learn/which-chip/ @@ -85,6 +87,7 @@ https://t27.ai/learn/jtag-asks-the-chip/ https://t27.ai/learn/same-bits-on-the-board/ https://t27.ai/learn/capstone/ + https://t27.ai/learn/course/all/ https://t27.ai/ru/learn/course/ https://t27.ai/ru/learn/fpga-is-a-grid/ https://t27.ai/ru/learn/which-chip/ @@ -113,6 +116,7 @@ https://t27.ai/ru/learn/jtag-asks-the-chip/ https://t27.ai/ru/learn/same-bits-on-the-board/ https://t27.ai/ru/learn/capstone/ + https://t27.ai/ru/learn/course/all/ https://t27.ai/learn/ai-numbers/ https://t27.ai/learn/t27-number-format/ https://t27.ai/learn/an-honest-scoreboard/ @@ -141,6 +145,7 @@ https://t27.ai/learn/a-dot-product-in-wires/ https://t27.ai/learn/add-it-up-every-clock/ https://t27.ai/learn/a-whole-network/ + https://t27.ai/learn/ai-numbers/all/ https://t27.ai/ru/learn/ai-numbers/ https://t27.ai/ru/learn/t27-number-format/ https://t27.ai/ru/learn/an-honest-scoreboard/ @@ -169,6 +174,7 @@ https://t27.ai/ru/learn/a-dot-product-in-wires/ https://t27.ai/ru/learn/add-it-up-every-clock/ https://t27.ai/ru/learn/a-whole-network/ + https://t27.ai/ru/learn/ai-numbers/all/ https://t27.ai/learn/goldenfloat/ https://t27.ai/learn/a-float-cut-by-phi/ https://t27.ai/learn/phi-as-a-ratio/ @@ -197,6 +203,7 @@ https://t27.ai/learn/gft16-six-trits/ https://t27.ai/learn/gft32-twelve-trits/ https://t27.ai/learn/decode-in-one-step/ + https://t27.ai/learn/goldenfloat/all/ https://t27.ai/ru/learn/goldenfloat/ https://t27.ai/ru/learn/a-float-cut-by-phi/ https://t27.ai/ru/learn/phi-as-a-ratio/ @@ -225,6 +232,7 @@ https://t27.ai/ru/learn/gft16-six-trits/ https://t27.ai/ru/learn/gft32-twelve-trits/ https://t27.ai/ru/learn/decode-in-one-step/ + https://t27.ai/ru/learn/goldenfloat/all/ https://t27.ai/learn/verify-hardware/ https://t27.ai/learn/bugs-that-compile/ https://t27.ai/learn/golden-model/ @@ -253,6 +261,7 @@ https://t27.ai/learn/build-verify/ https://t27.ai/learn/board-selftest/ https://t27.ai/learn/verify-capstone/ + https://t27.ai/learn/verify-hardware/all/ https://t27.ai/ru/learn/verify-hardware/ https://t27.ai/ru/learn/bugs-that-compile/ https://t27.ai/ru/learn/golden-model/ @@ -281,6 +290,7 @@ https://t27.ai/ru/learn/build-verify/ https://t27.ai/ru/learn/board-selftest/ https://t27.ai/ru/learn/verify-capstone/ + https://t27.ai/ru/learn/verify-hardware/all/ https://t27.ai/learn/clocks-and-cdc/ https://t27.ai/learn/one-edge-one-world/ https://t27.ai/learn/period-and-jitter/ @@ -309,6 +319,7 @@ https://t27.ai/learn/cdc-report/ https://t27.ai/learn/capture-a-crossing/ https://t27.ai/learn/capstone-diff/ + https://t27.ai/learn/clocks-and-cdc/all/ https://t27.ai/ru/learn/clocks-and-cdc/ https://t27.ai/ru/learn/one-edge-one-world/ https://t27.ai/ru/learn/period-and-jitter/ @@ -337,6 +348,7 @@ https://t27.ai/ru/learn/cdc-report/ https://t27.ai/ru/learn/capture-a-crossing/ https://t27.ai/ru/learn/capstone-diff/ + https://t27.ai/ru/learn/clocks-and-cdc/all/ https://t27.ai/learn/buses-and-peripherals/ https://t27.ai/learn/wires-that-talk/ https://t27.ai/learn/framing-a-conversation/ @@ -365,6 +377,7 @@ https://t27.ai/learn/who-holds-the-io/ https://t27.ai/learn/claim-and-release/ https://t27.ai/learn/capstone-what-runs-next/ + https://t27.ai/learn/buses-and-peripherals/all/ https://t27.ai/ru/learn/buses-and-peripherals/ https://t27.ai/ru/learn/wires-that-talk/ https://t27.ai/ru/learn/framing-a-conversation/ @@ -393,6 +406,7 @@ https://t27.ai/ru/learn/who-holds-the-io/ https://t27.ai/ru/learn/claim-and-release/ https://t27.ai/ru/learn/capstone-what-runs-next/ + https://t27.ai/ru/learn/buses-and-peripherals/all/ https://t27.ai/learn/ternary-computing/ https://t27.ai/learn/why-three/ https://t27.ai/learn/balanced-ternary/ @@ -421,6 +435,7 @@ https://t27.ai/learn/one-ternary-neuron/ https://t27.ai/learn/a-bar-detector/ https://t27.ai/learn/a-tiny-layer/ + https://t27.ai/learn/ternary-computing/all/ https://t27.ai/ru/learn/ternary-computing/ https://t27.ai/ru/learn/why-three/ https://t27.ai/ru/learn/balanced-ternary/ @@ -449,6 +464,7 @@ https://t27.ai/ru/learn/one-ternary-neuron/ https://t27.ai/ru/learn/a-bar-detector/ https://t27.ai/ru/learn/a-tiny-layer/ + https://t27.ai/ru/learn/ternary-computing/all/ https://t27.ai/learn/arithmetic-and-dsp/ https://t27.ai/learn/the-carry-chain/ https://t27.ai/learn/prefix-adders/ @@ -477,6 +493,7 @@ https://t27.ai/learn/a-correlator-finds-the-frame/ https://t27.ai/learn/does-it-fit-and-close-timing/ https://t27.ai/learn/capstone-a-filter-on-the-board/ + https://t27.ai/learn/arithmetic-and-dsp/all/ https://t27.ai/ru/learn/arithmetic-and-dsp/ https://t27.ai/ru/learn/the-carry-chain/ https://t27.ai/ru/learn/prefix-adders/ @@ -505,6 +522,7 @@ https://t27.ai/ru/learn/a-correlator-finds-the-frame/ https://t27.ai/ru/learn/does-it-fit-and-close-timing/ https://t27.ai/ru/learn/capstone-a-filter-on-the-board/ + https://t27.ai/ru/learn/arithmetic-and-dsp/all/ https://t27.ai/learn/neural-networks/ https://t27.ai/learn/relu/ https://t27.ai/learn/the-sigmoid/ @@ -533,6 +551,7 @@ https://t27.ai/learn/positional-encoding/ https://t27.ai/learn/an-encoder-block/ https://t27.ai/learn/ppo-and-the-reward/ + https://t27.ai/learn/neural-networks/all/ https://t27.ai/ru/learn/neural-networks/ https://t27.ai/ru/learn/relu/ https://t27.ai/ru/learn/the-sigmoid/ @@ -561,6 +580,7 @@ https://t27.ai/ru/learn/positional-encoding/ https://t27.ai/ru/learn/an-encoder-block/ https://t27.ai/ru/learn/ppo-and-the-reward/ + https://t27.ai/ru/learn/neural-networks/all/ https://t27.ai/learn/queen-and-hive/ https://t27.ai/learn/shaping-an-issue/ https://t27.ai/learn/a-boundary-of-real-files/ @@ -589,6 +609,7 @@ https://t27.ai/learn/the-night-watch/ https://t27.ai/learn/the-public-board/ https://t27.ai/learn/the-comb-answers/ + https://t27.ai/learn/queen-and-hive/all/ https://t27.ai/ru/learn/queen-and-hive/ https://t27.ai/ru/learn/shaping-an-issue/ https://t27.ai/ru/learn/a-boundary-of-real-files/ @@ -617,4 +638,5 @@ https://t27.ai/ru/learn/the-night-watch/ https://t27.ai/ru/learn/the-public-board/ https://t27.ai/ru/learn/the-comb-answers/ + https://t27.ai/ru/learn/queen-and-hive/all/ diff --git a/apps/website/public/learn/skew-and-insertion/index.html b/apps/website/public/learn/skew-and-insertion/index.html index 828a75d076..164e65b2a7 100644 --- a/apps/website/public/learn/skew-and-insertion/index.html +++ b/apps/website/public/learn/skew-and-insertion/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Skew and insertion delay

You will learn

Why the clock does not reach every flop at once, and what the tree delays of a 7-series chip cost.

The clock does not reach every flop at once: it arrives through a tree, and the spread of arrival times is skew. cts.t27 models that tree with the teaching delays of an Artix-7 in its header: a BUFH at 0.05 ns, a BUFG at 0.1 ns, PLL jitter of 50 ps, and a maximum skew target of 100 ps. The recording runs the native t27c on it: 15 tests pass, 2 invariants are proved comptime. Skew is not noise to remove but a budget to spend: a well-balanced tree spends it evenly, which is what makes one shared edge possible at all.

Try it

In the recording, find the two buffer delays in the header; then in the spec frame find the maximum skew target and the test that compares buffer fanout.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on cts.t27 -- clock-tree synthesis, native
t27c on cts.t27 -- clock-tree synthesis, native ↗

t27c 0.4.0 on a laptop (macOS): 15 tests of the clock-tree spec pass natively, 2 invariants comptime; the header holds the Artix-7 teaching delays (BUFG 0.1 ns, BUFH 0.05 ns, PLL jitter 50 ps).

specs/fpga/cts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -292,6 +324,7 @@ 

Skew and insertion delay

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/softmax-and-temperature/index.html b/apps/website/public/learn/softmax-and-temperature/index.html index 20be8fed7a..731919484d 100644 --- a/apps/website/public/learn/softmax-and-temperature/index.html +++ b/apps/website/public/learn/softmax-and-temperature/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Softmax and temperature

You will learn

How softmax turns scores into probabilities that sum to one, and what the temperature does to them.

A classifier ends with one score per class, and softmax turns the scores into probabilities: exp of each score over the sum of all of them. Scores 1, 2 and 3 become 0.090, 0.245 and 0.665. Dividing the scores by a temperature first changes how sure it is: at 0.5 the top score takes 0.867, at 5 the three are 0.27, 0.33 and 0.40. A language model picks its next token from exactly this, and the temperature setting of a chat model is this T. The spec softmax.t27 subtracts the largest score first, so exp never overflows.

Try it

Cool the temperature to 0.1 and read the three probabilities; then make a tie and heat it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Softmax: how a network turns scores into a choice
Softmax: how a network turns scores into a choice ↗

Move three scores and the temperature: softmax turns them into probabilities that sum to one. Cool it and the top score takes almost everything; heat it and the choice evens out.

specs/ml/activation/softmax.t27

// SPDX-License-Identifier: Apache-2.0
@@ -234,6 +266,7 @@ 

Softmax and temperature

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/sort-by-three/index.html b/apps/website/public/learn/sort-by-three/index.html index cdc45d9089..781f830b34 100644 --- a/apps/website/public/learn/sort-by-three/index.html +++ b/apps/website/public/learn/sort-by-three/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Sort with three-way compares

You will learn

How a sort uses compares that also answer equal.

Three compares sort three numbers: the left pair, the right pair, then the left pair again. Each compare answers less, equal or greater in one go, so two equal sevens are settled by a single compare and never swapped. Sorting with ties then needs no extra test.

Try it

Sort 7, -2, 7; then find an order of three different numbers that needs no swap at all.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Sort three numbers with three-way compares
Sort three numbers with three-way compares ↗

Three compares sort three numbers. Each one answers less, equal or greater in one go, so equal values never need a second test.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Sort with three-way compares

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/spec-to-verilog/index.html b/apps/website/public/learn/spec-to-verilog/index.html index 7613ed9417..312d4c1d3f 100644 --- a/apps/website/public/learn/spec-to-verilog/index.html +++ b/apps/website/public/learn/spec-to-verilog/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

From a spec to Verilog

You will learn

How a t27 function becomes logic, and how a clocked function becomes registers.

Verilog is the text a synthesizer reads to build a circuit. t27c writes it from the spec. A function named on_clock becomes an always block on the clock edge, and every module var becomes a register with a reset. Open clocked_counter.t27 in the player: an 8-bit counter in a few lines, and the Verilog it turns into. Its header records what yosys built from it.

Try it

Open clocked_counter.t27 in the player and find the always block in its Verilog tab.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

hello_world.t27 to Verilog, in a terminal inside the post
hello_world.t27 to Verilog, in a terminal inside the post ↗

A terminal in your browser running the t27 compiler as WebAssembly: t27c gen verilog prints the Verilog it emits for hello_world.t27, and t27c test runs the spec's tests.

specs/ternary/clocked_counter.t27

module ClockedCounter;
@@ -105,6 +137,7 @@ 

From a spec to Verilog

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/stages-of-t27c/index.html b/apps/website/public/learn/stages-of-t27c/index.html index 50129deb31..dea7df9a56 100644 --- a/apps/website/public/learn/stages-of-t27c/index.html +++ b/apps/website/public/learn/stages-of-t27c/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The stages of t27c

You will learn

The order of the compiler stages and what each one produced for the lesson spec.

The lexer cuts the text into tokens. The parser builds a tree of nodes. The type checker reports errors and warnings without stopping the backends. HIR is the hardware view that the verilog_hir backend is written from; the other backends read the parser's tree. The table shows the counts each stage gave for the lesson spec, measured with the compiler on this site.

Try it

Open the t27c stages widget, paste the lesson spec, and match its counts with the table.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 23: the stages of t27c, counted
t27 basics 23: the stages of t27c, counted ↗

What each stage of the t27c compiler produced for one small spec: bytes, tokens, tree, type check, HIR and backends. Lesson 23 of the t27 basics course.

specs/basics/23_stages_of_t27c.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

The stages of t27c

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/state-machines/index.html b/apps/website/public/learn/state-machines/index.html index be0d989ceb..be2b430777 100644 --- a/apps/website/public/learn/state-machines/index.html +++ b/apps/website/public/learn/state-machines/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

State machines

You will learn

How a synthesizer finds a state machine in your design, or refuses to.

Many designs are state machines: a register that holds the current state and logic that picks the next one. yosys looks for them and, when it finds one, can re-encode it. When it refuses, it says why. The widget draws the graph yosys extracted from real designs, a UART receiver and a SPI flash master, and shows a case it refused.

Try it

Open the uart_rx sample and count its states and transitions. The JTAG port runs a state machine too: in the spec frame, find the test that says how many states the TAP controller has.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

FSM sketch: the state machine yosys found in your RTL
FSM sketch: the state machine yosys found in your RTL ↗

Drop a yosys fsm_export KISS2 file or paste the fsm_info log: the state diagram yosys extracted, its states, transitions and inputs, and the registers it refused.

specs/fpga/dft.t27

// SPDX-License-Identifier: Apache-2.0
@@ -331,6 +363,7 @@ 

State machines

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/status-and-fifos/index.html b/apps/website/public/learn/status-and-fifos/index.html index b805b027d2..6c070ceb9a 100644 --- a/apps/website/public/learn/status-and-fifos/index.html +++ b/apps/website/public/learn/status-and-fifos/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Status and FIFOs

You will learn

What a driver polls, when a send is refused, and what the testbench of the UART checks.

A driver needs to know the hardware's mood: the spec carries STATUS_IDLE as 0, STATUS_TX_BUSY as 1, STATUS_RX_BUSY as 2, and a 16-deep FIFO each way. The test uart_tx_send_returns_false_when_busy is the rule a driver lives by -- you do not push a busy transmitter. The recording lowers the UART testbench spec to Verilog: what a bench looks like when the compiler emits it.

Try it

In the recording, find what the bench prints of the idle lines; then in the spec frame find the three status codes and the test that refuses a busy send.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on uart_tb.t27 -- the testbench as RTL
t27c gen-verilog on uart_tb.t27 -- the testbench as RTL ↗

The UART testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/uart_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -464,6 +496,7 @@ 

Status and FIFOs

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/stop-and-mute/index.html b/apps/website/public/learn/stop-and-mute/index.html index c6593d3fce..f5f0549464 100644 --- a/apps/website/public/learn/stop-and-mute/index.html +++ b/apps/website/public/learn/stop-and-mute/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Stop and mute

You will learn

What /stop and /mute do, and why neither can lose a person or a direct call.

cooled says whether 5000 ms have passed since the last bot message. /stop silences bot-to-bot turns in a chat for STOP_WINDOW_MS, 10 minutes, and a person is still heard: that is may_answer_after_stop. /mute keeps an agent quiet in a topic for MUTE_MS, an hour, but it still answers its own tag: heard_while_muted. Both are clocks, so nobody has to switch the hive back on.

Try it

Drag the /stop clock past 10 minutes; then tag the muted agent.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The cooldown clock, /stop and /mute
The cooldown clock, /stop and /mute ↗

One agent answers another at most every 5 s. /stop silences bot-to-bot turns for 10 minutes and /mute an agent for an hour. Drag the clocks: a person is always heard.

specs/automation/agent-hive-group.t27

// SPDX-License-Identifier: Apache-2.0
@@ -429,6 +461,7 @@ 

Stop and mute

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/strobes-and-waits/index.html b/apps/website/public/learn/strobes-and-waits/index.html index ef7fde6976..e1d3e53c01 100644 --- a/apps/website/public/learn/strobes-and-waits/index.html +++ b/apps/website/public/learn/strobes-and-waits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Strobes and waits

You will learn

What the strobe bytes mean, when a servant holds the bus, and how the IR sees it.

The strobe bytes say which lanes of the word carry data: strb_width_32bit and strb_width_16bit are two of the spec's eighteen tests, one word served whole and one half-word served. A slow servant holds the bus with a wait state instead of guessing. The recording shows the APB bridge as hardware IR: PSEL, PENABLE and the decode as the compiler structures them.

Try it

In the recording, find PSEL and PENABLE in the IR; then in the spec frame find the two strobe-width tests and say what a half-word transfer strobes.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c debug-hir on apb_bridge.t27 -- the handshake as IR
t27c debug-hir on apb_bridge.t27 -- the handshake as IR ↗

The APB bridge spec lowered to hardware IR: PSEL, PENABLE and the decode as the compiler structures them.

specs/fpga/apb_bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -415,6 +447,7 @@ 

Strobes and waits

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/structs/index.html b/apps/website/public/learn/structs/index.html index 49b3d80e3f..061bafdfd2 100644 --- a/apps/website/public/learn/structs/index.html +++ b/apps/website/public/learn/structs/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Structs

You will learn

How to declare a struct and a packed struct, and how many a module may hold.

pub struct Point { x: i32, y: i32 } declares a type with two fields. Fields are a name and a type, separated by commas. A packed struct lays its fields next to each other with no padding, the shape a hardware register has. A module may declare several structs; the lesson spec has two, and the verdict stays clean on all 7 backends.

Try it

Add a field z: i32 to Point and check which backends still compile it.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 17: a struct and its fields
t27 basics 17: a struct and its fields ↗

A t27 struct and a packed struct drawn as tables of fields, with how many backends compiled them. Lesson 17 of the t27 basics course.

specs/basics/17_structs.t27

// SPDX-License-Identifier: Apache-2.0
@@ -89,6 +121,7 @@ 

Structs

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/sum-and-carry/index.html b/apps/website/public/learn/sum-and-carry/index.html index 0888ad865f..a38498db6e 100644 --- a/apps/website/public/learn/sum-and-carry/index.html +++ b/apps/website/public/learn/sum-and-carry/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Sum and carry

You will learn

How the addition of two trits splits into a sum table and a carry table.

Two trits add to something from -2 to +2. Written in balanced ternary that is a sum trit plus three times a carry trit: +1 + +1 = 2 = 3 - 1, carry +1, sum -1. The widget shows both as gates. Counting tables, a two-input ternary gate has 3^9 = 19683 possibilities against 16 in binary. The lesson spec builds XOR from ternary neurons, the hardware side of the same idea.

Try it

Find the two input pairs whose carry is not 0, and check a + b = sum + 3 x carry on each.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Sum and carry: addition as two gates
Sum and carry: addition as two gates ↗

The sum trit and the carry trit of a + b are two 3 x 3 tables. There are 19,683 such two-input gates in ternary and 16 in binary.

specs/ternary/ternary_xor.t27

module TernaryXor;
@@ -146,6 +178,7 @@ 

Sum and carry

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/surviving-mutants/index.html b/apps/website/public/learn/surviving-mutants/index.html index 22c93628e4..8c0851c894 100644 --- a/apps/website/public/learn/surviving-mutants/index.html +++ b/apps/website/public/learn/surviving-mutants/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Surviving mutants

You will learn

What a surviving mutant tells you about the test that let it live.

A surviving mutant is the most specific bug report you will ever get: here is a fault, here is the test that should have caught it, here is why it did not. The widget counted them where nobody was looking: 367 PRs landed on t27 in 14 days, and 11 of them deleted tests or asserts; one PR, titled to sound like an implementation, deleted all 26 tests in its file and nothing failed. Every one of those 11 was a mutant that survived -- and it survived because a human let it, which is exactly the failure mode mutation testing exists to catch.

Try it

Open the test-touch widget and find the PR that deleted all 26 tests; then say what check would have caught it at review time.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Did the agent touch its own tests? Every PR merged on t27, checked
Did the agent touch its own tests? Every PR merged on t27, checked ↗

Every pull request merged on gHashTag/t27 in 14 days, bee lane and human lane: which added tests, changed them or removed asserts, with the exact test lines from git.

specs/tools/trios/tri/x7-mutate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Surviving mutants

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/swish-and-silu/index.html b/apps/website/public/learn/swish-and-silu/index.html index 03dada9adc..e364d980b5 100644 --- a/apps/website/public/learn/swish-and-silu/index.html +++ b/apps/website/public/learn/swish-and-silu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Swish and SiLU

You will learn

How x times sigmoid(beta x) gates itself, and how one parameter moves it from a smooth curve to ReLU.

Swish is x times sigmoid(beta x), a unit that gates itself. At beta 1 it is called SiLU, and its lowest point is -0.2785 near x = -1.28. Raise beta and the gate sharpens: at beta 8 the curve is ReLU with rounded corners; at beta 0.5 it is a gentle slope through zero. One parameter moves the unit between a smooth curve and a switch, and a network can learn it. The spec silu_swish_activation.t27 computes the curve and its slope for any beta, and its own batch at -2, 0 and 2: -0.238, 0 and 1.762.

Try it

Hold x at -1.28 and raise beta from 1 to 8; then find the beta at which the dip is gone at this scale.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Swish: one knob between a smooth curve and ReLU
Swish: one knob between a smooth curve and ReLU ↗

Drag along x times sigmoid(beta x). At beta 1 it is SiLU, with its dip of -0.28; turn beta up and the curve closes on ReLU, turn it down and it flattens toward x / 2.

specs/ml/activation/silu_swish_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -203,6 +235,7 @@ 

Swish and SiLU

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/sync-or-async/index.html b/apps/website/public/learn/sync-or-async/index.html index d8e597953a..55bc0d08ea 100644 --- a/apps/website/public/learn/sync-or-async/index.html +++ b/apps/website/public/learn/sync-or-async/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Sync or async

You will learn

The three reset kinds, which one races the clock, and the shape the course recommends.

A board asserts reset when it wants to, not when your clock says so: the assert may be asynchronous. The release may not be. reset_sync.t27, written for this course, names the three kinds: sync (0), where assert and release both go through the clock; async assert, sync release (1), the usual choice; and async assert, async release (2), which races recovery and removal at every flop it feeds. is_recommended() accepts kinds 0 and 1 with at least 2 stages. The recording runs the native t27c: 16 tests pass, 3 invariants comptime.

Try it

In the recording, find the test that calls async release racy; then in the spec frame read is_recommended() and check what it requires of kind and stages.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on reset_sync.t27 -- the reset kinds, native
t27c on reset_sync.t27 -- the reset kinds, native ↗

t27c 0.4.0 on a laptop (macOS): 16 tests pass natively -- async assert with sync release through 2 to 4 flops, the racy async release, and what validate accepts.

specs/fpga/reset_sync.t27

// SPDX-License-Identifier: Apache-2.0
@@ -327,6 +359,7 @@ 

Sync or async

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/synthesis-warnings/index.html b/apps/website/public/learn/synthesis-warnings/index.html index b701185d8e..31d0f86d9b 100644 --- a/apps/website/public/learn/synthesis-warnings/index.html +++ b/apps/website/public/learn/synthesis-warnings/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Synthesis warnings that matter

You will learn

How to read a yosys log, and the warnings that become bugs on silicon.

yosys tells you a lot, and most of it is fine. A few lines are not: a latch you did not mean, a wire nothing drives, two drivers on one net, a memory that became flip-flops. Each of those works in simulation and fails on the chip. Open one of the real logs from t27 specs, then paste a log of your own.

Try it

Open each real log and find the one that yosys refused, and why. In the spec frame, a cross-module pass counts what it cleaned up: find the three counters of CrossOptPass and the test where they add up to 17.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Synth smells: a lint card for your yosys log
Synth smells: a lint card for your yosys log ↗

Paste or drop a yosys synth_xilinx log: latches, undriven wires, driver conflicts, memories turned into flip-flops, warnings and final cell counts, read in your browser.

specs/fpga/crossopt.t27

// SPDX-License-Identifier: Apache-2.0
@@ -193,6 +225,7 @@ 

Synthesis warnings that matter

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/t27-basics.t27 b/apps/website/public/learn/t27-basics.t27 index a8dc4b2ae5..e938082cb3 100644 --- a/apps/website/public/learn/t27-basics.t27 +++ b/apps/website/public/learn/t27-basics.t27 @@ -226,7 +226,7 @@ pub const LESSON_ALSO : [27]str = [ "", "t27-tri-misread", "play-verilog", - "play-hello-world" + "play-hello-world,course-deck" ]; pub const LESSON_SPECS : [27]str = [ "specs/basics/01_what_a_spec_is.t27", diff --git a/apps/website/public/learn/t27-number-format/index.html b/apps/website/public/learn/t27-number-format/index.html index 7a10a2ee43..7cf00a1d07 100644 --- a/apps/website/public/learn/t27-number-format/index.html +++ b/apps/website/public/learn/t27-number-format/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

T27: a number format of our own

You will learn

How three trits give more levels than a 4-bit float, and what that costs in plain bits.

A 4-bit float such as E2M1, the element of NVFP4 and MXFP4, has 16 codes, and two of them are zero. Three balanced trits have 3 x 3 x 3 = 27 states. T27 is our format that uses all of them: 27 levels placed where a trained network's weights actually fall, and one shared scale per block of weights. On ternary storage that is more levels in the same room. Packed into plain binary bits it is larger, not smaller, and the widget shows both counts.

Try it

Move the weight across the range and find where E2M1 rounds worse than T27; then read the storage table in bits. In the spec frame, tnf8 spends three trits on a float exponent: find the test that counts its values, and the offset it reserves.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

T27 cell: 27 seats in 3 trits against FP4's 16 codes in 4 bits
T27 cell: 27 seats in 3 trits against FP4's 16 codes in 4 bits ↗

Drag a weight along one line and see where a 27-level T27 cell and a 4-bit E2M1 code round it, and what 32 weights cost in trits and in bits. Numbers from two compiled .t27 specs.

specs/numeric/tnf8.t27

// SPDX-License-Identifier: Apache-2.0
@@ -110,6 +142,7 @@ 

T27: a number format of our own

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/t27c-on-a-real-machine/index.html b/apps/website/public/learn/t27c-on-a-real-machine/index.html index 2febbf9e2f..878ecd2d5e 100644 --- a/apps/website/public/learn/t27c-on-a-real-machine/index.html +++ b/apps/website/public/learn/t27c-on-a-real-machine/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

t27c on a real machine

You will learn

The same compiler on a real machine, printing what it really prints.

The player in lesson 7 runs the compiler in your browser. This recording is the native t27c, written in Rust, run on a real machine on the same hello_world.t27: it reports the spec's status, the tests and invariants it emits, and the Verilog module with its parameters. Every byte in the recording was printed by the command; only the typing is staged.

Try it

Find the line where t27c prints the Verilog module's parameters.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on hello_world.t27
t27c on hello_world.t27 ↗

t27c 0.4.0 on specs/demos/hello_world.t27: spec-status IMPLEMENTED, the two tests and two invariants the Zig backend emits, and the Verilog module with its parameters.

specs/demos/hello_world.t27

// SPDX-License-Identifier: Apache-2.0
@@ -169,6 +201,7 @@ 

t27c on a real machine

}

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/tables-and-interpolation/index.html b/apps/website/public/learn/tables-and-interpolation/index.html index 5043b5c8e7..025316bfad 100644 --- a/apps/website/public/learn/tables-and-interpolation/index.html +++ b/apps/website/public/learn/tables-and-interpolation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Tables and interpolation

You will learn

How many sine table entries you need, and when linear interpolation beats more entries.

A quarter-wave table of n entries answers to within about half a step between them; interpolating between two entries brings that down to h^2/8, where h is pi/2 divided by n. With 16 entries of 16 bits the nearest entry is off by up to 0.049 and the interpolated answer by 0.0012. Past a point more entries buy nothing, because the b-bit words themselves are off by up to 1/(2S). The spec cordic.t27 builds the table and measures it against its own 50-step CORDIC.

Try it

Compare 16 entries with and without interpolation; then set 256 entries and find the word width at which the words, not the entries, limit the error.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Sine tables: entries, word width, and interpolation
Sine tables: entries, word width, and interpolation ↗

Choose how many entries per quarter wave and how many bits each holds, with or without interpolation, and watch the worst error move between the two bounds.

specs/fpga/dsp/cordic.t27

// SPDX-License-Identifier: Apache-2.0
@@ -437,6 +469,7 @@ 

Tables and interpolation

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/tanh-and-saturation/index.html b/apps/website/public/learn/tanh-and-saturation/index.html index bd71bc48b3..3a9bb32f71 100644 --- a/apps/website/public/learn/tanh-and-saturation/index.html +++ b/apps/website/public/learn/tanh-and-saturation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

tanh and saturation

You will learn

Why tanh is centred on zero, and where its slope falls so low that a unit stops learning.

tanh is a sigmoid stretched to -1..1 and centred on 0, so a layer of tanh units passes on values that average near zero, and its slope reaches 1 at the centre. It still saturates: at 2.5 the output is 0.9866 and the slope only 0.0266. The red band marks every input where the slope is under 0.1, beyond about 1.8 on either side, and a unit whose inputs live there barely learns. The spec tanh_activation.t27 computes the curve, the slope and its own batch, tanh of 0, 1 and 2: 0, 0.762 and 0.964.

Try it

Drag x until the band starts and read the slope there; then compare the slope at 0 and at 2.5.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tanh: where a neuron stops learning
tanh: where a neuron stops learning ↗

Drag along tanh: it is centred on zero, and where it flattens out its slope drops under 0.1. The red band shows every input where the gradient has all but stopped.

specs/ml/activation/tanh_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -164,6 +196,7 @@ 

tanh and saturation

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/ternary-computing/all/card.png b/apps/website/public/learn/ternary-computing/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..15a1a0bcdb3a5b49b56de27b187e1972a2459734 GIT binary patch literal 34028 zcmeFZS5#9`+b*i2q9~w((gakx2#A0{sEP;#0qHehqe<^Qh^PoiZ_;~{5=v;H3etP% zp?5;)J)xbM??3+@`*L6GvCp~K-YiE3AuDsf^Ld~0vi#pF%aN1OlU=xQfm}iUmD+_1 zmy0f3xa5585_qNI(b|m*7j9ipc=bZVHDPU%+#qWI^n5!H&h+Z1kMbK8MV*&qqN(+k z7ui<-k?Vyo!oNSa$r8%NKC4#M7uMq4))tK^w^iIVxm#r(z@77sE4HtZ{7Ex|<2xro zJ2IKue}~Q;5=mS|mJMh~MJ5ap%jwfLu02jYRn~PQhlD!Brjr-Kka%Yo8baNid7+ z{(oxe{*040+SK7+6SwJ0kL{Ro4A&%`#Q)lE4b}SnBfjqflKy}39sis5clE%h$fYk4 zi^o!tepY^qvi`8wTj901m76M+RAD>yZ>6p6JxMJ$^u~?dQnZ@-^pii1X9O(vJC6OT znJ3jJ6(1_L2{rbtGO-n?>ites8vzmJ4Sp{NKZ2Ty;?sna2RZGz>zm#hLMO`FCf?BNc!pdY?f*(S-7Dp|loqJF zQ+E*Tw;8-MaPlW>*Ct*zBJZ$=+0&{yE=>T+u)pfDt~4(vYbYR6WW=1gn$c|ksh4zf znOP!_ziM0&WAS#bhO~v^tunmmv+Pna;m~+?d6F@+uvIh9g|XuN?dj)YkIcdj`=YI; z!|7>-R}0n_9{zR7aKO#AZc4IRx{?s~7&KHbcqHSJ&d zF&~XdZx|q23F{BN6Hjc1{;ap=s}CabcS)xWicM4ob~L5pdA&92-Zvk7?4~xGjIA?2 zsL6P6TvFI`{P%CBehn|SinYUm&x60bHXKcD{NDhwl!->f%U`123B9PZ5jdhOww zgrmFrFv|Zg`8mb4;QK7+Y_BNp3v9c{(nKoviHSg-Ri16W@9!t^@HQCZ+U-wrH^R>k z7U(a_dW@Wpd(0HAe0$&jG0jiujq407n-j-u=j}cm@XaSkom7s!ODF6pJ4Ez-OFXGW zt#gep3rCN>u-%839seSSl$Wo#lTM-@aZ4EMH05(&Bw?YtXWh+Q`p9jr(WQRXE}ray zdvu_arY2f)4>zD)(CV?jy{mpcGLEoGHtf)Cf9aJ$=hgyIz=4gOTrbU%BR4y8Nro?_ zo`(ORs9owtjvPk1ted1Cro?Zc#LUe;QtUF^64W?jc(xLStVnQBXywgq?-lnPOl)F7 zjPG=0c`iSlmvHUc(-o$~I+*WVl#x?P7G7xDM|@&}jQ`C$4X|LJkg$lXdf3$#K=6$^n=+uINpx3H}7yJKC2h{*?_;q@W)N&r=M1C?Z#=BTP%4RH}w6y zxXCOwykxMZx>_U0M(+Rf$o7=5t|vOy>)HKp_j}ht|0Tf1G8l#Kk5xHFY+bNNZT7?c_y$w?fWtMA5nQW{Q8H z`jDWG!#mvE_rQT&iyv%!hGB8yPaeFVomtCBy zv7jnsrICRWd7wCVVqE?eg1jn`)4%Aa3)@k&)~h1uh4hgQakDi z`Ol;n)Q73xK4DzByXaj;!YdC-C1seUl5YvmGLJH!Mw+^s_LDcXvB^kfWY>x+~FvBtJN&Bp=#;ncm9C_?aFIds5&C;j?Pimy?*(+q_E~6`7Ou z7Zq`3yrSlOtle;_?caFBk3)uA5rXAyxrj`bXyis)^j(XcOt+~{kG{T@c$<2+oawFc zO^5^9&cvNOpl&kms>(f+Pw*l{ev5~^qZ)ejA$&=-B4o1SWnO&S&R-jCV|R#;!exf2 zPfEVaosttJ#v@_$^{F4N>m^zyOn>GV`BK1Aomp>FVB@_f(%-)-H~)}^`mp-MO}~6i z#1$iErh#7H=g!JWrRw`0&Dw|}Fu7z(7(B*J`HTeBo(31o5H1IyaLSzl`yK|TX)ZHw zOHq}Y%Sv#st2g6u~UkyT!7b;?8 z4GJAyXzCtgstOFX-shIx)V@C&HnfH5Nn@7~sU>~Q5ki;qe1xV~-mttNXD!cn^NiQH zW$q<@rh&h`|8Fhq4BG8~!l=(sXRm+eKl6Uoh1yz)Z|@cD4cg}>zh7a{jJkM^PtPr} zMW$hreJk(q(*cY(Of&MQ+=}wo=7ni`ephHlkBB{c{~^PBpxrp=)t`s;f;?=plTc$> z8{VX_aKp!Z}X`XTOLa{>}Yc07eq&u-=j!q{9ZqPV5d9wH!)A$ zZ&(}-Z6ur7+y0tlBzmvOC6lxu}Pe;lZm?azzEb*zZ z_~%}(YE$&Kuy13jFVMw`?!`+-b&NLFT=^wET}~7N1D$+kW+_gF&jg&;#o$Y8vGcOA zh_S5bv9Ifr3bg&T@CrH z281g%McK#qj_SIU=#q1n#R(L{di=}A$#1Drt1QZ1Sacj3*Oj-URF7{4*R(7KtPQ#R z)P*kM(~}v+3-0}U=u;T;0=gMWKp*QZ)yB0dp8B-((at`B4_g@11D6lTuI5 zozL%#3--CAP5SyZ1@3gCRpO700<3Ix$}O#^2>JeRhKq~rY5-MJjp7YPh@J=OWu5Fo zkx(N{U%kf*g1e$cxNmLkVm#|NH`jdwPM$74&6Zb>Nqk8=RK{(zZEP%R)g02&?0EU8 z3ltSN8SlMSw@ZnXl)kVsw~C~b=XLTK)FGSlmZMwKcIvV#b8HMB z)(K9^58M+_2q}DZ7{@Mq}*lLnENICf^I0 z@qY?BIU3`prKjVXVmo@B4Wff;{i^NhS!BvaPQzir>shwzLb*1WjGE75Z8gdlwUdS< z`PTYovIy+Y|G+tLQ*KN+zrA?DkyHqMk@J)t{`tY$P(_HE!`^5+JWQs*=WXrxqQW4b zw>mcOP_F%F`n=8|Etv&eI@+dE6+*3n&X#=k5?-x*=7|H$*I7n$pQf z{0zlCPF7Oqp>jCQdL}+dPsT}ddq)4nb1qW~MsZQ`mbhyn9=2I9s{wYKD#DxYey?a; z*9)}V(OGf&Bp0n)JVI0Km5P3FlzwD{QjP+$}>QcSPiIb-0?$JFb6n(5g*gF0tR zXPRLa<(Fl2C|PO@blt0cn&vs}wy|4YE8@|J)R$0XKQHW~s*1P(Q-nGWUKFPFwo z?`m?u5-PWuY=hiMX5Fv~g%F1~gim)PYUZ+2uDDX9&Uwo~S6@0IBhUrh==k-W-H@a( z%R~{2$>3)pj5)@LYyZ-yqfQm8VcvF%n^ar_=aL1CIdMusYXlJ|5s$9_r%w`MuKT zh!`?;mUJ5auA3JeD+8DF27i3wQ}CYhI&mM;Jyo|?{BJMd&p*5&+^g0jQQPl+!5{R> z1Hmhxk8P+zNBa2K7qP$D5gK>vb|!FssNqGgBn_#YHyMzHpv;uMxyrB}CQJ!D@Nlw% zGRCkmhZT?5STL=ACLlGcU09*q^^w`t*)l>~*}HNTuk8MmYmFtfA8kXjN%5Ph;^1OXYk+e#LqC92ey zw>gsnU%iqp$0I~zv2dOof*olU7woHE`Q>-;i$V{rYdjys>`HziBFZTRPu zDTG@y${h_u*(T38nV zso1-A^+0u#7Rmm~!APp!a5d3Lb5TtdpxzrQ z318+h5NC0J*Vu?0Y~-i!ZI~&hy3prjAZ}!+nZ1Xj8m&k+N)8k<{rq|13R?-nXj*b= zHOfqr-sNwV`_o#qE@ruy3TBwdW;0+h9*C^|_&J!y*qXCLqvqI9K+xS1J(>!aX_<05 zZojLia@#DqRT&xW_<4QY#Xdjo+Ho{@;@Vs+;T7%eN<`JyVIRtmIbv?M+Dp-ghgF_) z-_`@>9(StZr1@#`o`9C{g5(lu{P6)~DOOUPMclcu!KY8^!vU&bwdryc3C<*^m&WFR zioB_PkUGo5#8s8wR_E(J9o1if66LNU4_Ix`(|2C6rfQ})yviI@-%QIwLrgs=X8qqE zny%}lI^T(jPO@dGgB|@b8{br;7`)k~qIm6Eu=3BFuB8sosV+2F(OCQ$e8^5X+GiX@ zjNqSPc{OC-A?lVcW=Rf9k7i}xYAjt%mRa$dj3mvHBgDGH9BtZ?;{@aapQ$7r#yhxZ z)Jwh?A+P(;8(Rt$PGNr;7=YWC_Y=Yr=7t@57=A?L zwi#9IfANFBPlmGlsy*erv})_ozLleS9!8>sv+25%oz5E@j`THIcAsrr>T+8S!YfYy zP3@oO=k_5~c&T$wQ&uIscbC{M?>qBH+)lTt-5+M2zV)d>ls9r?G!79gLG|?MgD($F zE~Ipd8D&ZucULD@B`4b(?ldc=UB=Ud z8Ltm`y#4q4Iu!s(TmC_X&S)gO`*|#C+i!n_Fy>n=slk_a|CZ1hM7y^KH{{YMG-Bw{ zox;AESWw^FrO&9Qg%zQ}(cc>!TyVmDq*&dfLAI1^raZ}UTMl?^`AH}+b8mi6^?kmK^ydr#rxyXwN<%Qb#20C4>vz`d`DLU*E8z?VSq=>eR5#n=e zaX;k6S!7UX8ah|qNI9~TLq~qd${nPb zCXHxB>iLc}v?(eMdCdHFyRn>^k-;iQVTtNB%qfz%!1_+d(Y7h#p@*W2LDBx~Hx6YD z1KX1wLOToTbI+>t1~c3)&O%v40{X9CTMUifF9Z_w` z)sW(;-+sZ8{gJF;PFjHkBHrdm|6lwt=I6ROZG&f>*QT$#6hv7jvC=xugls; zsn0zcx$kA5zbC`v3Tm}ip#v)K?>XhG8aISK2w`muT<+Dc)`+)MufI6Fpy5&%TgK~e zo6P#M-s0;C>cyiy2Ju(5@Af=rEmWk?Gya;)9UU5kE94tE4R;ktlp$B0*HD?E_F^u- z8H$bMY9qIILR_77%hP>!#Gt_RTECqDga}B{HLAi^Kz`PE+vu$bo_dwnS> z3>$A?6(7>}$tLm(g0*L~s7>zv$rTY{<-IS*zBasR@-$K_N%#8MN zC{yVh^Ig^zcD-kVscyvA=oYiELEe`I+Q|;ie!BB@F@!{aWHE-TdxwJ7)jUVpW*;M~ zT{YmIoF^bnv>TL%1-AT&ni6eKI?%zUR%prg5*Kj8I^Y&TU?%V6IUo|-iQb(8o zA=yGw6}ymcg_LAZWaMI%NYboT{856H%k4G4C=)j4KF@|5KH=-~^j=tt_a)qYHth6%w1%ke)?d?Z3hNKGpB?kZWL!#M;=5yhcwurz zp@vVvRSvK}g0mU^dsO}VpWz#)m!K`H6*v4dgIxGlQXAisvfgV^q|Q3kiC15TT;C9_xNRtMwDjxS zH#gi4-+qoJbylyUysbo%%3@FR^^a<3=g8;7Jwl`xK@c@C_uTGE z8qux|S2Y_k)_2Ny7nq+XGx^~{nzKVJF+05Ql(k9fHxu!Hzy8n0gE`jB*Xr?03|EMs z4QVotfn_7pyp9is1_w2?w4x&;Kbe~LCQErYe7Q*0 zceVbgnJ*wP&=?`^u+$}WwjE+O-@+vwGMuN4h%t1>8l4kHzTcn;W|lge^4NrV?GKTm zqBU?fzv6I%|q!+2;9~O-Ce`Hq0q%_%b?07w{2*Uh&<<7^BD1H+T$dj@mhrk=~i* z<<5jXEci#(M+Jl97dPwA&nUf*WR7W65=0(mzdYESMx?~2`1SQIb;YI+`97=`c0cI* zZ!e(YQi@`@VSbs#2qfdhb^{6J$%>qm+6+`)zD?>J-|NQ=*Wn-!n5y;YO_I=er|>2W zBtKqB`a#Z+wT7vWH6_aIy;)D;B$9#D=?_q>EK2<;=>Na$Q(T7T3zS-IqsuV zXhm#in9sIIuS}AHWFJL`ohQ3_(-D4J(#d-~gn(x@w3m$-9v{}9OFVmq?#7;;o+f*2 zh+Z-CKi;TTaaT+*+MKRG?}`<;o5F!wPVz9QgU<&EPuVt+lcBDIkpV}6+1Xh=n=xKH zKVNc&=X>kpBd6GUAXJWyT){6%mGS#r>on;!0yc~#o4wnlbhvsW*;gi;<<=!>VRc>I z+J1}`^JtP4|G$G!@t7x_4D?vWo5sAwf+ib5+=LA zij++e_6Ah$j#hyW(ic2i^{3)sC1(<`mAV@!& z2baHCFM;nmUTPY$iyImmQjC70`py)cp#aeq6b%&=fuFddALuO$*W-galN#pc=Js(T z+|nw0|EN?dJ-sGTPI4hknte*Qu3b!t#}jaf>^HGIy zGi6`BGH_drYHx4H$iHYXXXL4Hz zyFtS{T7MK%e`0)gf+s_T7(#_zPL8%ac`cUA1HOO%Zr|pDAMWI<_nh`RRmC*iV`rh=UISt~(?C2v8qnqo@C~ADwVZWr+Oy{ zQ{vPT%;+(ssjc8vX*>J1`2)UH>P+?R+Zp>0x_;B=XNSg6-5?<$Ar6%!ajY7 zdFxN?byb11E%3~4|3uj78H3E5Jo z3g&)QQ6GN^(!uK3m=CwNtME(l+W9)Op4b?Td-~;;Rfkg^V72p|_D4to5H~TO*&eKo zJ&RCPRqdfVS-0`_IKwXs2ngI2J~}?021P1h(iKV))ufN!h-4orG4AZ>>@*H@GRfLb zM${f)BDvHJl&e0qhc9-@D#tIh~Skv2B&S&`~1*5(I_SwC1{Wl z?SjvBnQ~j^kiz??DN=mfspg#yzr^B~iQiqGb{@Bynwp~6gzxps^-3I0lv|C{8-?*a zv%(1G9wyd9I~3gA2{-s^w(!fz+}5ExyLm>Z(BTY0Q^u+A9Tw8?R%UO{xqtoui!wSx zI{ysU_sQz9g0pynRq=kz^KjW^(bI2jCjPlq_?=O-*mpgc`4fXmTP!-0clxs`UBu+7 z4=Gb6IPVEG-Q^An*B$G_9v`HO0T(Sr3T;gi9 z6A3|nOz!f~xH%?soJc+A6<6GFffXV$L4`_QMvg3eEk67_v0m$OD6HC9q22p*e`KFw z4CWv_*gxfw^8qFpqd5D9EW0UnJ;eJYeeDO-fm;h2Xt~XNx+2%J3H>f*GbJucQv}LZ z-?~b+9~N*RLN<OuPrHHv8?v@qCIp17*2hV7D!Wd?Nx3qR9de%%;5U-}XLB~zUP9s-khpk9I@iD zFR%%Xc*6`onpF~>%nIBD}KPlgM3QYh+{;vkAS+zOH@!BPk`52IdJn z`|HmQJ|v_lPwly!rrC)kjlU&R2{E#It9s^d>nDzT*clrU({VVN5Lp=+JZidfste5`#_exYK2bqvy@J3N_ zfJ?mG?PqED+&0eW+~X0l|1su0KV;QGr6ko9*z0mO@;2ATD{% za!EYMjTK0y?D-M5gz}v)L{^pg(XEJozQMQk>u}if45V}h0UamZBPVa6{qu#Q9SikLoL6)&aVPha3z?5C7Xw;8a%R=8pR^t$_A+uy0JtkmiFqAY+6 zOR$S94TsEYbr!O6WSe%!4Xr8I#Y*=mJ?7clYNGT$*>2sSW?~rIKyya=7RL{GWT4G% z;Oz_UNwZ*;!{8+5hGt3+7+@INJG6TPDH3CZlDC00e9rj7jJg)VQF*<9+}vC}Us;!; zXe}t<4dL)i(aeFOa*hJS++Z>?GGugx;{Utc@+Hk>=oBSN2IZ#t@8!C%KS)83ll91l zi4y4FcI_;!U(27yzJZt*^&f4|OA%JmFOpmZAFaAIq-`{$;M@1&!P?sq1BY&6JIjS6 zPRB`lp&SpZr*l5Dnu=uzu_rn~Nmn5bVjc&UDiW?r6!1HEgSs*&+;H_~oj&%NE#5Rx-2 zml5$6OR>hy#wBY5_ynk8tIY49)ord%)#?*WBb{e*K@arUOoesC30a^A2BMPE=5JUX zKIXAMIbG!Q&UJhb35tD=hTL=f4cg=Scty3i7>nu_0Moa9dY2o6*f7gz+6OOO0JB2a5^g4(_pB_&0opwPj@JC1T)dt>)jyDUy zx2)bsg$4Zc6?ItRl#tD)##n3U(TCJSN0v(X2b_6Bt}woV#zd<5(Ja16JJlqZUAgq0 z!`95Aqg~HjTgW3Zq>f8Hi>Hr6_Kz4!+igrk=Q~s+xyI_AYf#>(^jYhAV$mb#!#Z_J7io`4myf z)5MP^}Q$%L_9c$Sc7<_E?csJS=nllA!KQ*o0n z+GB5`+B_c)qhPnFEIxmMP8sGjoeLJ*C_2yXxm^+XYbdp8c547WY3$?UQ&2}EZ(oM| zJ#PMu!w;IS{)<_vZresQ(HlVJXC++?4c2k_9+l(c+xSqVSpIcS|O>`mpLe{s%Lmxm8%b0nzmUgosbykv3Z3kf>yV2vy0I%Th@$ zbZ`ntxE6ESjN!3TT&dp2pTZDOA8`0tdjtof{>(jO`jXw=O8?idm#}r!2N;X=^mM?A ziAU%7x*;5IT%cb}b>|MfjY&070E~s*7OVoBxpGtOp3qq0*|&e@w5k!)6ge*DMcC7~ zsbw4JTnZf^g?!u_L+Fe>DiI+}dv4AAt*NO2%1=&Kw#;m${&=&#er#$}!sDQgK4Q{< z@Qy(SgDJDn@An@;L7PfHB}XOZA(4CMr}gK;4oh!hRDKl|OD*zoI3f$_!>!Ta#)YrW zQx=?U`AO9P*2%jGiGEk*gwq@V}B{K*;{i z$`<(aGp=Yu6%-V@DR|k6b(gd-{AzToMts7?9n`t9lb)ln*0ui>_0Y~zyv^C^rnk*W zHucAXQ`OZ2qOLeVv?XwEgkgG3f8Y6UFF>b9SH3;QExN29<#7+=O09)ij~C1AbB3DR zsh74+EBB*Xeu?S1JlRUQ$9O9H3bSe$WEzBv6nG7MbNSRFU?W!pw9M+RHwD z0vSG>93SbK#rIEkd$Th$+pA;>u$i3WOvfHTK$;6lFJ9LFSXXj5`Y|MkNdmK2_-Glk z&l24v-3~04e#krdfq^Qj&D`vy)wZfK{AwOzLE6~6D5j_Io&=i-P{Ic+n)2SwfTX7k zRfhT2BG(s+vUQld7v|^F_si5e#Q{9<)$XZ%{LVl}N0e3lizHw5USRs{kIYZ(b59q4 zuJmy|mirzeNmv22(DAIY>xbhI=BiorRn#y7xi|cP$9^rcWbn6+n!0*vX=!T^L$**Y zQi`>NNzA$Hpf@`it{0b){yNBBwAgV%=!}O!wx3;&dTetoIhUub-jXHJuAP1#J0Rzs zQW_$4rsF*7eKOA+gqQ%fg}pKi^RqyteR37r_fZow%I)RA3x<%!^~3JYXdZQBnR@DaBzlg*CAgjuF%%SQQnsNp z^MXg>!E?zQ?k&IQAcypAW0%c81M{QdKt=a8HZ!#JVRsUjz=KPvrt)ict~c$V(2fj+ z2qe?+nCq(X+GugW53CmNG@Aa$6bq$zUq6?_@j`?OM!4oxAbO_CVfp@sRJ8Vj4rg{C zQt}a_Z@HAgRi1d_-y^7LeeC@aG-zgjrf|tuP%g5(IPn)!sv>*HZW~kxDxtTNw|cEd zY%`Li{3P-B@0Fd>Y~@6~dN_!c)V##@j1(MREqj(P5O`^5 zXvphpVg4QPLH(lc-^^e^jzxS$8y5`pghq!ZU~GRv?%ZBazBK))piod;HoEP-qb_zP ze4R75VR0{LWI^6-fPQ5Bz*9Dpjg=f~WHFx=6Z|SyL90N|xV}b>M8x3IWYr!w8#c4Q zN=GrE7<9>M=gceYi&_|Gz0<<&?d^@rjTGbLPRMB{jDLm;Mw0yT@CJ1zDK`J*xR7Gt zaqD#OV06o`IxXfK;%)dZM}0Ds*!#B_n*J!urCmN6x2`VWC&#p9MIxf~3LRQEHoji_ z#`Iw90S8Ab-bs`{-Qn}F2{0q|Y|1{^R<)?JuV<()mCJ7T#tQxba`{}OhO_qba&NLt zIiwO;cx6-J!(U|Rkzoigz$(vAmZi9@SQMJNxg}Wp6{Nm&Le=e4F26LdwqVo8=Vx!Y z9RtW;+zJ?M)YR0}<8Q$qJ+4i(-!bfIL?zU1dpI&tvejOuC?I9P{*6e7m1-Za7+hsJ zuG}Mc-#Tk3*Pu^Q1D3~0n(}yBSPxZRVTqca*}tE+4<5dvj{~km3DbgKPm%<8P-(@K zdtRb-k0s+NRKY}l`SlY~sdf9C9J;%}{**c%>otHwvp32{-dCpvAB@Y0g*hfXme4c3 ziz(FAn~*wl&L|f&*()RH%y98i{#3(PJ4g?jXB(TER*N&Tm(7ja)EAtK=#qSROGlYg zY!9DI)Rz=LZo?9-6l=-Xwp?J1%{|Xb+T|S#6nd=e^vN zsB%2ef)fd9^c|onp*kxvVPS|X0Q8W%yT4u3<8Z@iw~;}(EEBy&y-USUQf0n%kSTE!kANx*o{VXAyT+5y*CY?@=Vkp1TcAO>>gJr4m=U%(WrQm+s<%`1Ne6 z9KMWH$##4w<}{mGs{OQqQzOAY&l`g(Wcxgte8M|!_#7gteqbz&I9oMXNBKFY@j5}% zBpjis>m`|)tu`A;ua>t`)vcYTo;?9K_6MmZzPyJWfL3D-9dNfHrrC}Z$@bKHmfD|7 z7aC#{6W4bNi25HF5XgJ{)SVF`YEVp(1?)nx5e}jqh2tq0r~TDFZyIbR!@N(M?0r@> ztdEu)t~ylUFi)277%m;M5i=i=pkB{bC*#SyVwLTHdd|xF3da)=DgbEgK<;<__tSM= zP>)qZhjC}f^@k51zQFNZf5+q&sUDcGTiUXSQ_og*!cVk;T!CmqL0!_l3kl`p)&uT} z-WMzwVh;00f6?;K#aR@pzFYK6*8?i=1DX*#Xc=P!uNscl=+0SE6iY8C%uu^zGkKeS^-NbzV)Ruq67RD z)5b69zN5D+rnMf2QxiWrKei8xxh6)e7Z+Gh7nw0KeZ1$oaI#ri3{k6U0%z zV|8n`DQZK;UDlD8*A-v{%rKCNk+EQRkjk%Ey1E1$zkWC*ug`fJo#s$rX=_{5B$5EA z6@KclE?dY;7*k#SAQ9(BdXsjhB)1fP>YmP6HVJg$Cp~Qf`F)YT#oY-81pz@WE(NU4 zq=ogk@-n}A$t%zSmTC{DEWCN&KH4DC7-cM!09l6KoB4RNZ|h5D)R`zoO?}TwDZMmh&z}1Mmc(*GFP!NTrT^ zzO?{C9s6c@7MQw3|9kze=#?#?fV)K~QBij@o%~A@oV(lF`cMTceo`m1fY^^DB-~Hj zUhzI2pN2>^y(XBbtE;m-dK78>^8DFF(U8!X7;POL&OFr~?o;3zg{u{)LoSIp~+JVBgBJB3Ct*=col0l_xssWD>7u z*l1CVsePbigs?7Vd%$eaVXhSKIU=Cy5CqKd{K0ZVM&ZdcQ2$or<#+GiZO7)s#nI<7 zZ`SPg02Mp>8XnUUk&wPxWI^ z#cyPxR=&ufV~nTE|i^?Hg^tE&PeOb(}TCjJR;szAjNmP1bCBAu#&kwl zkjKXRI36v@(|XpO~O8oBM}KomGUmh(LTa^a`kSejzDSxy-VA-X`p4DB-6ZI zK4|ZPp56u2x;cX=1KSJKI81f8(1R1BLi7go^`KB_hD18@Z}Qn*_Q{Fo6{~~NMhjyv;BqY%V>_3~_ zgUsW2Q3sRbp)=sR0Wg8)dE)e^pY@RAtaMc$0l)#e_5k4tT0LZd8DK9~3y{h(=XJeI z@{Rg)xPLcPc<_I^yL(S`LZhNGkpW2V46e)ustm-3#&6e|yk8fl-nv#D0Dw<|pTF42 zSLqbr>m9A^4~UB1e{H+G$v()UvAinl`nB$5Ju*RtAjnR#tNuE82KXuP(BEQw9KUqN z05Mm#x5}lvi$0#L7MzfzqR8ZFGmg(E&};7Mylsvw?W93YolrKkLvd z!Lg4xWBa=Phj=K6PRyUYLidF*IV3Oa7${)70VUz~@W+Wzi%-GeGzf?2Og4{|ngWFc z0ckA_;ZMiFe|rH&o~pqmJyh~zz$1%CTIwCr3Y$CsN4kCq+Z>@+R8YPse=q#157K0h zw0`67!eIWlS>W19ouBMNjNg=pQNP5}MmntO^?rZ@$0{Rtp-=2#@yW2hjV7u9I7n@3 z-oOz8)B453#>Hr|upQ^~)5G}grO3!gYr*`S;Dae5eW>em#-U3-wg!U)pPhrlf*hd- zgYj?#0_$4{40d$K3v-(Zt9_{7P2BAI%`emQ@C;OR4@kVLhYDfUOaK*t-)frdH9Rt+ zjhiP@z7O&-Tq}*h#mTU*S&FmBP-7A_3r$c7*Ha^mNrLnrRKqlsW}tSdJm?cY+jPf8 z=|^*5(1(3FVd3e6Ws#^J_H3ritB&|+!QAm@Wb!mFpzIYNT)%OHXgOJ>hsfu8fMC+8 zhq_$j?b}e#s{1{Ql%g!W9Dmr@mX?<65s@V3j2!{t?$TP3?VrNQA8Ps}ggMpI@Pk7R z@&G^_qo1dFZWUBattzmTQqn$^{!FPW_4n^zbW2q9Au)sAoSqhVnG#JgN?e~x;`%%i z;KP0X9i{OFoHYA8x-W%jemdUTV8pG%&T zT)2?pr~5wBn_uJe=hd%QZWz=#t&Q@FhUC)TiTQO&qLmW9pIIZ}X z+f2j3E-f!Dwfy^MrbIJVnBsrPXlNvVe75oXd}~Ouq?h|lgO5q6?ztj}S^TH3=~mn8o3!MAV3n7^$7d2z;z3m5vD zKsLGsayIDreQ{S?(8L3ZZ(s9CngKHpL+%#)t3%+?7t+0IhK6V9%%}3_qEv(_;GwFf zzusSKZ9w@-Uvu=Rm~8cp;M-p5 zPY3wY+up9)_dlM|-zTmYEYU@TG-pCyiW07W7rBZH_~ zirZc8rJ9+(@AxUY?s#$&5Z?1ZzPiwmwqJ~*_OHx+L7>h11gT?YnwbUh2Oe8lMs#s5rSbbNZ&Uc)Hq zDIzR!o7D5?gsfIfqG zgP_nWDk2J3nC!i0`8xvfoCg|K8p`a%)XJ==Ifs|wS!;OOEtLMOZynJl2h&7#=>4`OTesrEXh3vMk6NX)z}9?8`Yt{CZO@D-N&`6L z&tbY>AU3H1zaAfB%@DKQjej zqSR#qNJpptb4qGzWJClI&zUN0FwVBtRtDc+ct#JBITb$Bd_RN(81<2o^yyj>ppIYM zXh1+=qa17U-Cr5a5m#1HYQNlZonr{#;6$UCxm=poQ*B&(Bz*t82c$NDCnx}evl-1M zsA`@8E}&Gv{I#9}Qet=T^=$-@q>O_UqTL8(V{z;MB{#sGB2{3`ZV@YKT=b z0A7gmkL>oC8%K?rPP%|~Y*y$Wz%?57vjdGboRbC$EX$gZcXIq=!M99clLL3e!$BrXdJ%R8x~lM@hn z8&cU0%uHv%Ll*xI0`FYCS;GCiN8O%MF4g)rW4X@PGd^2}$wl75ffn5FUR_Tl1beRa zlg&v3>;a&?c->v#b5Lxf^1{UNQ1t<;Cs&`}`YM_|a3z>qO11p~S%Tue;uR zi}cjgAU(ZeTp7?u31aD-azf()?@P%n010TXGt$#b5BGtY{o-u8!$l=bHgN#ZZr$D8 z0j)vOy}r@Cn?%G;)#KL>ymKMDq?8md0QGR^{<#q-N@UFQ?ouwm*%!VGTp!zO0CY;o zw_zZ4MT3CxL&DU60x9DZi zsx}kdB~V3L0goZ-C^$Iy-@MQUO2gmdIakLvxcwB{&KT#egupUTAjk9G|Em;O+t@g? zvC=0zQm$KU!<0jAe1}_Hh|Ko@DPZUtbTGiKH22PvhnE+b@$~s~jm?QaiDU3ZbbCkU*w(-Y2w*6n9DT&`8B(Fu}ZQFtFwM>}rL&Cci%IC?^(QHv>KV9qsAik(#VOcKCiZ^=!#zXyspWg5gt1BznX4il|ehEmN_Ce)9 zk*}%IvKP#m+mV%(t;^-P24EIuKGK$sKz>te=I`IXz+5NV%3j@Q_m77ia~Zi>j)smm{vh z9zB#Gp>`(oEdcao3fU*36oBE^o{ol1LR`8haf z#5_wUpFLqvGOrA|z7p7cWUynF%r|mlfCJFcP1JmRU=>X;1#p2rfOx1beR*_aDg^w( z*vbwmph8|V-{>AIg!1z8v$L}gPD>`PFUGEKv{+zl&s$U9Qoc`2oK(m~sJBTBgpp%_ z+)oS=a)X1go-B(_MV^rWvf8ngKF>h40CUfy>l@R($2+OdU%sSXSKcha?+=mp!i78a zc2!ORip+MkH$FD1u&Br$UpDLG$BzKW=^=T94+2!T^On}uz#ILtSVglr7Yc=rNnab= zUeJ))6#e@g37}+5==lN@9Oc+-t6%Nadd_Z=lf880Cg5b|sn*yJr;A69`aGH&ps1H&xs^fMtLp?wVX-J6mIYLxED;*OS<}VLgB^rTp-Dqz!;TSvWbjfW`Cn4FX1OL(&X8vJ*y?y>?&%!AS6s z0YCm4@Tr@+{~rGio?gAYh-CS&^a?zdVl9HEzdW|3g0VXGEL*1{5EFsT<50K*5YeJb!ECY_irZ0JYGPqs#`jo!;}eJZI662ad;bAEjfX%bySm{nfWN8Z zOgk5VwFL=Mz%hikZh7YCGTsAhNWMTPQrgQK@?p(t`_o1ICi4C%Fr`;`M&In4xN-G3 zH!Rcx^#^vLXKKoK8C;-{@PL$bIwaA&ATcrVv7pV(V3;6r&<`|`W}pB9Cf}I@4skQg!kB0RX!7Xl`nneYu_GfRZ@eoc_wOgG zwLXFX)WxeMz8UXC8dmP+KyGPivoo3$Z*L%mZp^Vm&dnwg zao__%TQwJ#U0sk#(aTwW0JzP}=)-)(+5R2Ferw$eUoZm1mBLQP$~L`fQ}S~F^75Is z`rgQ=Q|~MS0aO5xg++&wz&`BMn=tPJ55CjSZu;aBi8GG|g8eLMq=aM)7%P(q-`v2faNPoMhLL^H1Ri1{8pwm%=Jmf^r zQH3J0^=ONw*1f`R9c=AaV%!cMupRGrQ;aEK{xpo&uC&v1P_y!Bet39(McWJ2aH%kA zaQ5EmBe>GS7W1aUX3X~I_9pe02jhW^^m4+hhorq{T+Qq6qLRD&Qq_oY<&v%D6N%7O zuh^3GPb)TKY7b7(9e(TR>>4$WXS~^X+Wm;lJhl5eqm`+e5!=#?&%|1aDNVu3pFuY7YvV*`z4V>8pW|qBzOHtX$4NaSr;-pB)rrsA_+?nyj!Ie^B${d&wEFouRA5tUIG?*5K=o_E`a}nVuZqG_A+;2g z28qKqJz6^Nw>~o=wghj{s4SGNe5yf@YgERrNIns{b&CN>e&>5gdU$PQh;PJC`3#SS zG(QfqvxIlKz{y~n#~sy9r^ktBtL~;ijyEwa;C(|M9$JpikGjY(Ur>O$lK!~G9UotxIPFA_k% ze>Xl%FhS@UWM{NbX_*h0Hr2c!G1N_4FSboC55Z4=bH|fUN27%wDQ6Jy%7@+WCcR#> zW86Z=g*dqQRNAU5CHRBh^e!8o4n3jVY%=1*eA$GV9*u+J19En^D#d*;$(gSy%@`SX zUjME<)*rmicG)f>~?j|uO2JQxM;dXs4HsOHM+jn3H-a!c2*Es zFJ}UWu-Fpa!?@C0Y#76j^>!a^&W*wvHke5V75XpDX6cyjV?K0Rx{5;~mJS)^ztY z8Dx1Vm(z#5;BnEKY>a+*%H$=ao8jW>qULStmekZhN98rqJNT!NknjcBca#|)=iul} zcI`B9THB?wfQRbiI=1gZ|JsbDTP-U~{7RCpKf1{t)R;Iyz z4-}6~p{p=mY;3*q`ox|=iX)@_kS}I`eZdCpml5)iV;y0W7_BO1*|6dI0}d>kI%;Hb z6+#kl z=5Tk-1%ER9a+iNTK`V)moQ=ANyl*YFiuSF8>#+|Ojdk}dQku0-=h|m;&`5iGx)b=zq1ro1 zY<&^PkX9Dg!``F$Gu#{)w?|GPXg~Q6R#>;Bj_Trb_eK-o;vg}~-2a)h#j0v(0J8_* z;vMh4{ayW?u}am2tMitcXg&f-xlWNsoN$1{{T&w=y-;A$4>2s`5I3&ae^V?&w)$4T zg+I>yq``MP=$cG>b4>L`a* z-%c44+12DWIW5O0CJ)=`;4r?5i;pp^mEbK|*4QQ&a@m+KtG21^b#+MRd-f~2Xa~ z+PzbLuJTg3f;TAcrxpj61Df%Snth*CiQ;1)+jrDEc_csgxvGo)sO(|&Anh6qKBi6% zuu2zziN+WtHPt><(qmonZSW}maX!slE?m0d2RPCt zO?sD{Ld3&G2|63Rfdo@iYHMs<5NcniXAs*a)N`AWuzGoFW+XrcN=Ea7%Kn*odlDZ_ z8Xq0!$TK_QR=FmAeVm_O=8<(#UkRMUbjtt2?Id%3RDJP7%eLs4`8(Ocd3&tIOE5p@9X%hw!^uIZr4xa?{%VohugO z*LW+iDpxORb93n@{^FT&5+`*RytP#>cW@^v7zwDOo6mV%GDbq1Ca{!xmv~ZZdIQe4 z{O(SG*5G{MALY3MbF$T>*hT%_4<7Q`E_(?spzmK&{JLA^==sXWONYHM!`?H2yk;i! z@US6LRl_PFrkQqGJ3SNU&HEI`p^!#YCB_m90|1azbOSq zlim!ydO;GKr5l2%T3dIpp~bD}8l70HDH4;iV7|AsSCnz^a-ofMoXU<#X`fMk@XZIk zcN&x}+I?(Puq4gHsi+zTKj5Cl81OS*f30e4oOy4?p9H$}=>afEs`M!RV#c#gQ3&OA z{@3XAztOLg)Gfv5**VOwET^0(QB9Mdj73BBb{MGy#nha=eewIoa*a&dc@~yu*6C;| zD-fxB{QX07j+(>FE4@9DzoTYNwuIawo;dGnBMluXQ)cC zjg*gstPMwyeyP73AKQ(O-y_dTRW{cRW&+EOkS!bL5qDP{4Wy%GpQ!D#kNNiW zxi@C5?Hsg$V$@NQAt~ucnp+ab#>Nhn2Yu>dVgfT2b|FKOt*kZA4iG9yaF~QLtiqAh zwqnuPQ|%F`s7GshJ6ldwRgt3!L0-bZ;?(obBuao?OKI3#lNrqPDJbYo(#Du{gVpTu zhJVd%#8f;cGR4wpJi3vr9pBLeeq=Sx!Icn8a{qHQ;r`OxxI?l8jU_Kw>4T1r#@m4+ zk2^0kJ2A9eqsZ1tgEJ~^szNz@#8_}Bv|lMnlt(rv2yXmJO^Soh+9rsWN80$Qqp1n{ zYjhQdS5~B$S_K1{vuZf{pj+$0nf3Kxh>qPyiar8ruCg)cf>CP5vC2399`DyW?n;4G zfrq;!bnZxAO%pz|J-q>t@$lAspEEIAfUf4Q+AIXYKKD}||Gd1%K6RVuU{3YKu3<2j zJg;gEpE%Kp1Ty-bTJPH>vz`{zgt)B{*pmXoan+3e+Sid|V z)o2~wpGu5V(i7QMXP7O>+FTrd1?x|rCAKZ=X_gg}oHXu>=v}T+4RxD>Dq9Sw1r+3i z)yg3C`rXkBy{Xp2Ne_@p@Qs8x5)zF9)Y_?_y5x7=DnqQd%bWk^0&1k2bt8mf!##_S z9IahoVN62Y9x$<5dSNq1J&?lAuY)%jF?Td!+wcQM*J=9sk@Ced4UmZTX+w>-*9wG+ z%5hab^OgAv=3(nC`-AVP&=9Y;8*?^m#`c<_V$L}f+Kyhd49iDx&i}Tng4^cZ9|Sg! zHz<&M$Q0Hl`P7Mho627kZqG#N;^wR=sAt*|XlQlPN-fc(GDZbY#s>Fgz#~AUa#sKP-k;X& z?9V&T@F-cWQE^Ox!_QFOzV@SNI8I@*bsqY8xaw&UwDAhv^0jbwpq|$5nr;Z*)ulf>R#kicjH_e$qOO+xtAigEl0wmX3uALtsJ#gZKOamTzX5TZZ9?@u;8J` zzcT9ao&9@sT=e|k&TmI>9&bkGAazqI_jIqH>nb2PwUR)f-KCD{iVj$l=spp>Bp*v3 zN()D*s8VmbZ!u6W{cC-r&=uMN<<coBlqm=6iC z2|EFiH5nXgj>h8+Q*y2}HmA}bBzBUJA&hJ$*P(zK)Ynvh-mr0AlyJv%5v-1=vY#-% zu-AHn=UAhfGBRnOpZff~j5Uc>UCSpoc7b~bt*muh7*+Dp!&pnj#tpTfXn`$SzPyv@ zu)02f*reSPa3Y+ldA*_BPL8umaPD+a7EDvldwrQO^eI9$UD}K{aPp7ZV3397RI2%* z^;pbU^qN7vjjUfNT1Ly;{vXknY@Au^3GUQP-KbO-lN*-2xN!CZS2KZ>4xkLP@;fjyPA?71aJL@ooY@Cil_?O&sy86>J?AjrwVYxK zT-VWaUkt`RYYp=Ga02n~V=a>^GCFOj_x55sM+=fPRaaNly}vvUSIKn9`Buy=H=qfb z>eWt2(|ebd$?=-_C||~UZFu$-_JaVWy!eU8?j(}63BL%#I4MqzVo*O!Idim$g`INY zRtMuVLBC5E(j0ivA0|xVf|krFVTsM!0m3EJrD3z_3h&sn&Mxc4p9CqW zq*G9@m@z6M*0fL`VggOz&WXPo6$zQ|zRZq+Ntw?3-ajUNOl=9Pe$er(m}{2{G*z(+q5ubeYi*5_=T_ExKcBiKT| z>1L7q{oWxDc{=(Em86j@I9t%QXgq1^rt@fZo*(D^EDzWT4qrZ8pRtlh(##F@)n!1% zqmc)?>${77DLzD*FrJ%qB_mTGzs4v$>aS_jvpe$mL5Z|A<|tcBzRj4mxM}}eVS;;Y zKsV*fZCX6Cf^OKD%r}WwUG>5aSOUxPB`K+AFHmt#o)w;Y1Rgb16R``9sI}ymZ4zGU z{+Z7IEGj37)}wYct6w9T`=R@S@Bv&I2zxs7RI`3#H1x(= zt6F3=Pq1z;9wZn^HTVQ1Jz~~&9jzPHd;cyRu4bo+4^|b6%JxZ&cdS9?{1jmtJ>CZz z3<)V=xny=bdil0Qh6Ha=2<%ds*XV0=4K!tF+RDlXYLHs&x6%RkGAVOXKX=wK;PJ}y zB94#?KSS_mvLD;|2uTYbw?e1u%bd^9-H*@GJTclLQ9CT-yVSY%5~OyzCaJXt8A3P< z!mXaTgbyYwMm5sHW)W!6h9f=yw@b)~j=sCdrl=kp0PwVy^(*VkB)98oio{H6C&ZZ3Jax$Ne=ACc z*DU>vLYXDlhm6>m%#O}?6Lx;b3`|Ck1h`8I*L@!J&xK!6sFqC?aAf{wltSypQ#Ay> zddyhsuNnqkWW7A%Ry5ScKibBE78%9jU_s8uQ^nr4bgod zm2qyl_K)pr#9D-A5)vywbl`2XxoiK5NSWXAD^4s!00$;2VJznx;I3j}%SgF;=FY-b zPiIlm+&aJCyNz)l;$-cD{{81Kn$|uw#{l2WooZM_Vym-A5kqo-kFk7mD8vtT{;dt= z<(%0Ioby>I1GmxU)Bkp%>W}$GC&)3XPp)sz#eRpCW|0@v1${KIcI8<)yAd@z~_|Hhc`0kSP2b( zlVtVFpiimWaC{lTBv~XxF(~##?|gbwMp>rf_-(oLv|05MG7`$iJ!6zf@nrt*rvazA z;!P_O@jVjET5931-osP2y!@w*RydM8+$U!_V(Ql0!!<6RComhJmY;4t#Ht&`8k3l5 zvSSOKwCqYjuRqx3+m98IOa;z*Fs)0J2In-EKjSJ|;YgsT|84z1|LnSM>Vr*ml3ALY^`jHCL0=Xo#O8(6YY29~vu);9;zEoLzJvy8qHBfOPO6mY0uh zsZuR?Yq21eFWRa(`=~AU3kv16$(1AWr>y1xJ#&jcDM4)1vuNe}zZHA9$fqrknQf$D z@iWMAAeCWnMc7ka*y&3w6X<1_ljL0dV7rXDO%i0N(5UJrfQ3OBX_VXi2_h}!!zQQ< zwlUXsR7J%XbSLGIDd_y;cKA6r*y2uL(WLOYP6PJAZgu&hCd3h>usO&}sa6ER$1Xj3 zXvH0#dK<*u;(nc*=uxd1-&RbI1m+Y5#GBvDn|{vIbw-0hvTtVy1*Z+5=M8lM1$X@p z?#}lfLNWMH`F}5doqv_BBCqKkcbGrG{-ZCRofCzeeJcW+uRY6PM_KLhH{|*gKUesy zrsQ|lv$^@%QKE;}_A*s+U-qp`8O}Ht^xjTqrH;Vt?}E0r0(w*>Gtfyyb%=1@gKraO z>=$vi4p6e~BNZBb{9mUGx%1vFRGnAhBqu<@rmNY>oerj7ZlOGPfY@3_W8*Cc$rgRS3oKm)uWAuw=UnDd! z8AIsF98vsPQ4AJ!PK>NxLrB=sl`3K(D(!eU`X5MI*5YOqa*dLbuj9bDNA!Fk=uVKa zO=+_l9c+IDam>WA7* z%qtGkZ7A!>5TBqTEh;sU{c9u-olll@`nnwi-eNd~|L7gAd_BUbELu;@iLA$aOyI z;)YdZ|9-bY#W)nPnsnb((e2OdXU4dJ&kz~Xf2=+Ph4%%mOFJISmTAH z#NhozzWYhbrR>Wuzi!q^1T| zk^M684LPH+oz`AzX}$3NZCFav5V>1>D4suT&4&6nViBqv;2|6-2dIBNa`OKWaF})$ zXfuc)C94Ndx1MUP4{#moz6r-Um3GguC8=YxRyMhi7z9Z2e$!uv20DBO4N%AE7@!RF zlZ#L`ofKf+7f_OE;<;C_lrm|w)s@tzo|S&Ig>`CL!L}neszuG5so+0Uy&noU}pr-`;gc^Rv`GU?SLo-YywQ_ZchQgv zY_eptA3RDBMHQu@N_0Y^mMuPAg&-!3tz8^6 zt#?mHHoqZ@t^q4Ge`}y|)C=v8&Ur8?AK*?HpATbtxMOssx2|FRl`3+b5<|3~$mprN zoUVeW3VN4j56<7j0@r0tUQ>y5<#eWgvh0m$bYm+q03?SER07zzz2$Vj8M$l)otQ|R zURk!%K~fp{nEi<^&8Hd;_L|Lw!iVx&_i_oQyp3EB3F8Qz{kz`)(!%@^QkkK7bJ147 z=|omuE+eS$fQMUK`WGby`Nm4coxFSwtO?#=Sz?W_F;)j;kk}BkQ=_og5-@QWJ3@}P z%p7Js|5ek()IxLVm?$RpL%YY1HAV)?wO&#A=~@lvYQEA(G`kKXXZ`%%h#ndetg*1x zC4CTmm)J~cv&$+wYnjP5<~bN+{ugnTbIy%8fBPu$QP*w0wu&OOmPPdEYO%_&^|WFfx+Y3>PdG&wbo^Dp~|E$>Av znY)kiM7JG7uwwQJE~Y)ppHsMNl_|YWa$knns9=4{B1e|}0XCc3vJG-=Y~bbr9P8C0 zjR}$$Oz|5p+I-f8^U7Tc1jrY|rTN}VS(r}_ao8}Z5f|)QR)BR}y7lJ~0VR!|C*-JVyyPFHZq5vbZ|Qv? z!5qA}E!7d}#S*ty8QtQChDikLEDka#Q@9?9noM*VxWuA=5HM2K8h__yQf zUKIV3nUgbYXqFwj{_v3oyO0TKinTm$dc=tRD?@Lq7EaE@?qGY3>`FDnbq$fsGPh#2 zS#R;`_Edg4AtCcNH5jes1W{8pHLdu9hl+~gz%)`0a1yHCX$#Sp9YjQ<@|Ylct_8LA z(vRq;p=UgW2K)4&Sz)NhQfUS!`4csxzu_#y2G6~$0))7^k-5^dlN=R&Jyv+498XokRxmz^9`a4z31^z~ zi$>gW9z;&v^{;eaYGG_yMcPCgdx*hOI)TRX(N}2Y>0mDt_MHirQpkLZThR`W`LExz zhe<{ODo*oHLJM+^{SCU3%QWi?3OAe|@h&lX{np(GD->`&7(dv6`yQ4hXrbz}cBQ?@2KYAsnc`tNIf{@}49cW$q*|UaJ?xJ98ap>24 zx7y+!;T^P{F1dWH#c-n=v!v(b{m2P&zQ@ji*>C(pH<)ihhTMG^7(_%7+)tULz}JiO zdeSpGLFnO6_Vr?wtxp9jnVvg^uQC{bO!eF^Cb!nE$Z!SjDQg=BhNmqh2Pi0^pfruE za6)d2ke$_AJ=0my${!jyJY~&J2YibP?hsjeNb@qG47?!Dy~g9jXcWm={PE9UMKTPL zn65<`)G@GB)na~hIQx?TPA|yJV>tX3_MtJ=+`s@P@iTJk8K$=B6FD^>$>3tPfrd*K zpZTO6_SFOipzb5r-J8>IXRH|tafwTQl3=TziWND z4@L$x0xARVjF`XJ-(Pl)bMmqlb(|_d;FBc3bY!R&Ya1`=_wtXsx?Wd@_u9L*xTdY za(lv-;qup1=O>HxtT0=WybxU&k|q%V;?+$BH>8c*lv!E-PK%!VTMeSh;9gS5CEs zZ&(#Ii@r^_wiH>w-sw_cXO){};QZFaw&2y|uy9q{pu)#>Xt?z8$3t9bV<&I>=R)}` zb=tecsiQ;+#LKH?r3su8m-$ZOhMw#8u5L!t_XzqfBh|FkEIQDx)m?@y-G0hwll zj2RdxX&#FCyZ^R3=X4<5v=X|HGd4+u2R03yWxpg$uI*aQx>}4}=Qi?)2r*f|YGoR_ zhm~a+iFFoWNMq$^20@&4nrwH7?c0g9!MEFnH5EBEy%~9yLS`ryBYzivQSA^IKU))D z8lRZjo_^P}435o@PHkX8Kj$7w%Ydr8CpNx-Y;8c`YwHyH==il=?9{#O}80h`i{6N zm))J?7@i8Y&<^iD#XF(?x#n8IIF97jpik9+bUEZTt06@L>axm}>y<}N8ikNS-6bP= z2A9JaR5nLSd``2LrbtxU)J7@qh-s6A30Ca~YBxa)N=i$Z-tm+ZQ6?Y_YVMeP;^Lxd zz4&Q_y^|^bs-*~V%3%omgQ~39s0$(hk@_NK$ZSgFB|&xOMVCP@ZsIP#+z0kQ<1Xi0 ziWDm9P)zR?Wz@-ZgxF6^s<7tm;ZR(ZA(p1`W6RAIL?r4xWs=z~+LgJb;-<-#ZN;iU z#KBFria-9K3O<)6wZMEoYT_r0+X zKTw^ULq}6~Q!5Q~k%Mei%@5-k{B7QNYud}h7G$j|{Z<|?9HwD@6^<3QSI@cIKdD0> zT+Z6Z<<979e6Nd#*0L(2tQhOh8N6QP`B_+dD>O_Oeyex-#$!`Y&Z!Qu`~ZYwiS@5mvJY(mWW0I)5DROYZzhB=IE7W~pPx1NK}#AYiR-UUMX_r` zg3j2sttwyla?f?JEo!@NNv-Dl+8t7jq?@?6s$qS!$EkpiOAdEcC01hKb(;NPa{B#CdI5geX%j zx9MQOR@lh(LX&{Gj+=0o@12+8mmT*dkI5%fX6?tNSXvwKDxjI9<%%25eBql9jX%k00G#*@H_hbw;1qxMiESZcGpD;4xNo{ z34hY2AYK>j^%4RTZ$z`74TGr#Vl%g+^E&45R(Ow_TPhBI%#}X7C^MxQFM- zEcI;FW>kd;r=*mvV`}K$SO_gFglg^YF;YCDBzJ7VFOuMAPFU>B9TnnmF;vnDch$Nm zjGcT`ZN_^~>N2d02@LLnHQXu}k)AS^OWR-+=95A|0yj72A7OX`wtv0$0gf;pUq%>t zq#}xjbEqh3Xr4T~?h&RJ`%x1xG8iAwc>TQ(BA#38uDCGVBxpH;*SQQx>r>`@ z>Ri0>89tY|@1bpT`-wT0lyi_2;;+U{fYXdU?|Qw`OnQ4H=X7=2XGq!@Q>y{@qg?7|K8hK{Ij)$Ln*6&_OHp1;u0r + + + + + +The ternary machine: from a trit to a running program: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

The ternary machine: from a trit to a running program

+

Every lesson is something to press. Each widget runs the fn bodies of a t27 spec compiled to WebAssembly, so the trits you see are the spec computing, beside the spec you can open in the player.

+

Course 8, 27 lessons, a live widget and a t27 spec in each: why three, balanced ternary, three-valued logic, adders, multiplying without a multiplier, trits in binary memory, the TRI-27 instruction word, a ternary machine and ternary neurons. Every number on a widget is computed by a compiled t27 spec.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · Three values

Why three, how balanced ternary writes every number without a sign, and what flipping and cutting trits do.

+
+
01

Lesson 1 of 27

Why three

+
+

You will learnWhy base 3 is the cheapest whole base to write numbers in, and what that argument leaves out.

Writing a number in base b takes some digits, and every digit must tell b states apart. Price a digit at b and a number costs b times its digit count. The widget runs the spec's own cost(): every number up to 999999 costs 39 in base 3 and 40 in bases 2 and 4. Over a long range the price per digit is b / ln b, smallest at e; 3 is the whole base nearest to it. The model leaves out why binary won: two-state parts are cheap, fast and robust.

Try it

Pick each range in turn and note the cheapest base; find the range where base 2 wins, and say why the curve still favours 3.

+
Why three: what a number costs in each baseThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/radix_economy.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

Balanced ternary

+
+

You will learnHow the digits -1, 0 and +1 write every integer, negative ones included, without a sign.

Balanced ternary weighs its places 1, 3, 9, 27 and lets each digit be -1, 0 or +1. Then 8 is 9 - 1 and -8 is -9 + 1: the sign lives in the digits. Six trits reach from -364 to +364, and every number in that range has exactly one form. The tiles under the counter are trit_at() of the spec, called once per place; one of its tests reads every number from -400 to 400 back from its trits.

Try it

Count up from -13 to 13 and watch which tile changes; find the number at which a fourth trit appears.

+
Balanced ternary: count with -1, 0 and +1The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

Flip to negate, cut to round

+
+

You will learnWhy negation is a flip of every trit and truncation is already rounding.

In two's complement, negating means inverting and adding one; in balanced ternary you only flip every trit, and the spec's negate() does exactly that, place by place. Cutting the lowest k trits leaves the nearest multiple of 3^k: 8 cut by one trit is 9, 7 is 6. No tie can happen, because the dropped part is always less than half a step, so balanced ternary needs no rounding rule.

Try it

Press flip on 8 and on -121; then cut 13 by one and by two trits and check each result against the nearest multiple.

+
Flip every trit to negate, cut trits to roundThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · Logic with unknown

Kleene's three-valued gates, two gates binary has no twin for, and addition as a pair of tables.

+
+
04

Lesson 4 of 27

Three-valued logic

+
+

You will learnHow NOT, MIN and MAX extend Boolean logic with an unknown value.

Let -1 be false, +1 true and 0 unknown. AND becomes the minimum, OR the maximum and NOT a flip: Kleene's strong logic. On the four corners of each 3 x 3 table, where no input is unknown, it is exactly Boolean logic; the middle row and column say what a circuit knows when an input does not. The lesson spec writes them as t_not(), t_min() and t_max(), and its tests check the Boolean corners.

Try it

Find the cells of MIN where an unknown input does not change the answer, and the same cells of MAX.

+
Three-valued logic: NOT, MIN and MAXThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

Consensus and any

+
+

You will learnTwo gates that only make sense with three values.

CONSENSUS keeps a value both inputs agree on and answers unknown otherwise; ANY takes whichever input is decided and answers unknown only when the two contradict. With two values neither gate has a counterpart, which is part of why a two-input ternary gate has 19683 possible tables. Both are fn bodies of trits.t27, tested on the input pairs that tell them apart.

Try it

Find the inputs where CONSENSUS and ANY give different answers, and name a sensor problem where each would be the right choice.

+
Consensus and any: gates binary logic does not haveThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

Sum and carry

+
+

You will learnHow the addition of two trits splits into a sum table and a carry table.

Two trits add to something from -2 to +2. Written in balanced ternary that is a sum trit plus three times a carry trit: +1 + +1 = 2 = 3 - 1, carry +1, sum -1. The widget shows both as gates. Counting tables, a two-input ternary gate has 3^9 = 19683 possibilities against 16 in binary. The lesson spec builds XOR from ternary neurons, the hardware side of the same idea.

Try it

Find the two input pairs whose carry is not 0, and check a + b = sum + 3 x carry on each.

+
Sum and carry: addition as two gatesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/ternary_xor.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · Adding trits

The half adder, the full adder and a carry that ripples left, one place at a time.

+
+
07

Lesson 7 of 27

The half adder

+
+

You will learnTwo trits in, a sum trit and a carry trit out, for all nine cases.

A half adder is the sum and carry tables wired side by side. The spec computes both from trit_at() of a + b: place 0 is the sum, place 1 the carry. Of the nine input pairs only +1 + +1 and -1 + -1 carry; every other pair fits in one trit. Binary's half adder carries on one case of four, ternary's on two of nine.

Try it

Step through all nine cases in the strip and count how many carry; compare with the four cases of a binary half adder.

+
The half adder: two trits in, a sum and a carry outThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

The full adder

+
+

You will learnWhy three trits still fit one sum trit and one carry trit.

A full adder adds a carry from the place below. Three trits sum to -3..3, and that range is always 3 x carry + sum with both still single trits; the spec's test checks all 27 cases. The lesson spec in the player is a different machine: ternary_full_adder.t27 builds a binary full adder out of ternary neurons, the way the repository's FPGA BitNet work does. Same word, two meanings, both runnable.

Try it

Set all three inputs to +1 and then to -1; read the carry and the sum, and find a case whose carry is 0 though no input is 0.

+
The full adder: a carry comes in, a carry goes outThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/ternary_full_adder.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Ripple carry

+
+

You will learnHow a row of full adders adds two numbers, the carry walking left.

Line up full adders, one per place, and feed each carry into the next: a ripple-carry adder. 13 + 1 opens the widget: the ones place makes 2 = 3 - 1, so a carry of +1 walks through three places and +++ becomes +---. The spec's ripple_add() is checked against plain addition on 198 pairs. The lesson spec builds a 2-bit binary ripple adder from the same ternary parts.

Try it

Press play and stop at the column where the carry first turns back to 0; then try 40 + 41.

+
Ripple carry: add two numbers trit by tritThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/ternary_ripple_adder.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · Multiplying without a multiplier

Copy, drop or flip: a product by one trit, long multiplication, and a MAC that only adds.

+
+
10

Lesson 10 of 27

Times one trit

+
+

You will learnWhy multiplying by -1, 0 or +1 is a switch, not a multiplier.

A product by one trit has three cases: +1 copies the number, 0 drops it, -1 flips every trit. The spec's trit_times() is exactly that switch and contains no multiplication. This is why ternary neural networks are cheap in hardware: a weight of -1, 0 or +1 needs a multiplexer and an inverter, not a multiplier.

Try it

Multiply 25 by each trit and compare the tiles; then explain why a weight of 0 costs nothing in hardware.

+
Times one trit: copy, drop or flipThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

Long multiplication

+
+

You will learnHow n x m becomes rows of copies, zeros and flips.

Each trit of m picks a copy, a zero or a flip of n, shifted one place per row; adding the rows gives the product. 7 x 8: 8 is +0-, so the rows are -7, 0 and 63, which sum to 56. There is no times table to learn, only the three-way switch of the last lesson and an adder. The spec's long_mul() is checked against n x m on 243 pairs.

Try it

Find a pair whose middle row is a copy and whose other rows are zeros; then multiply 13 by 13.

+
Long multiplication in balanced ternaryThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

A ternary MAC

+
+

You will learnHow a dot product with ternary weights becomes adds, subtracts and skips.

A multiply-accumulate unit adds input times weight, clock after clock. With weights of -1, 0 and +1 each clock is an add, a subtract or nothing: the widget's nine clocks make 4 adds, 2 subtracts and 3 skips and land on -8, with no multiplier. The lesson spec, ternary_mac.t27, is the hardware version: a 27-trit dot product over packed vectors, 2 bits per trit.

Try it

Press weights until the accumulator lands on 0, then on the largest value you can reach.

+
A MAC with ternary weights: add, subtract or skipThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/ternary_mac.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · Trits in binary memory

Two bits per trit, five trits per byte, and the bits a 27-trit word needs.

+
+
13

Lesson 13 of 27

Two bits per trit

+
+

You will learnWhat it costs to store a trit in binary the simple way.

Binary memory stores a trit in two bits: -1 as 00, 0 as 01, +1 as 10, the packing this repository's hardware specs use. The code 11 means nothing. A trit carries log2(3) = 1.585 bits of information, so two bits are 79.25% used: a fifth of the memory carries nothing.

Try it

Pick each trit and read its code; say what a decoder should do with 11, and check what the spec's decode2() does.

+
A trit in two bits, and the code nobody usesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Five trits in a byte

+
+

You will learnHow 3^5 = 243 fits under 2^8 = 256, and what the 13 spare codes mean.

Five trits have 243 combinations and a byte has 256, so five trits fit one byte with 13 codes to spare. The spec packs them as a number in base 3, each trit plus one, and unpacks with division. That uses 99.06% of the byte's information against 79.25% for two bits per trit. Bytes from 243 up are not codes at all.

Try it

Pack +1 +1 +1 +1 +1 and read the byte; then set the byte to 243 and explain what the widget says.

+
Five trits in one byte: 243 of 256 codesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

A word of 27 trits

+
+

You will learnHow many bits a 27-trit word needs, and how close to full it runs.

k trits need the fewest bits b with 2^b at least 3^k. A 27-trit word, the size of a TRI-27 register, reaches plus or minus 3812798742493 and needs 43 bits. The share of those bits in use climbs in a saw-tooth towards 1 as words grow: wide words waste almost nothing, narrow ones up to a fifth.

Try it

Find the word length above one trit with the worst share, and the one closest to 100%.

+
A word of 27 trits and the 43 bits it needsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · The TRI-27 instruction word

The 32-bit word the Trinity emulator decodes: its fields, its 47 opcodes and its 15-bit immediate.

+
+
16

Lesson 16 of 27

The instruction word

+
+

You will learnHow the TRI-27 emulator packs an instruction into 32 bits.

The TRI-27 machine computes with trits, but its instructions are 32-bit binary words, decoded by the pinned Trinity emulator. The opcode sits in bits 7..0, the destination register in 12..8, the sources above it; the immediate form gives the top 15 bits to a signed number. The widget calls the spec's encode() and reads every field back with opcode_of(), dst_of() and the rest.

Try it

Encode ADD r1, r2, r3 and LDI r1 with 5; say which bits differ and why the immediate form has a narrower src1.

+
The TRI-27 instruction word, field by fieldThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/isa/ternary_encoding.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

The opcode map

+
+

You will learnWhich of the 256 opcode bytes mean something, and what the rest do.

Of 256 byte values, 47 are TRI-27 opcodes, from NOP and LD through ADD, JMP and HALT to SYSCALL. The other 209 are not errors to the emulator: decode_opcode() reads an unknown byte as NOP, so decoding never fails. The lesson spec, t27a_mnemonics.t27, gives the t27a assembler a strict decoder that refuses those bytes instead.

Try it

Find the opcode bytes of ADD and HALT; then press an unlit byte and say why a strict decoder is safer for an assembler.

+
The opcode map: 47 of 256 bytes mean somethingThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/isa/t27a_mnemonics.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

The immediate

+
+

You will learnHow a 15-bit signed immediate is clamped, stored and read back.

An immediate lives in 15 bits of two's complement: -16384 to 16383. The spec clamps anything outside to the edge rather than wrapping it, so 20000 becomes 16383, and the field round-trips through encode and decode. The lesson spec is the t27a assembler and disassembler, which write and read the same table both ways.

Try it

Try 16383, 16384 and -16385; then find the immediate whose 15 bits are all ones.

+
The immediate: fifteen bits, clamped, and read backThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/isa/t27a.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · A ternary machine

An ALU built from this course's adders, a three-way jump, and a program you can step.

+
+
19

Lesson 19 of 27

A ternary ALU

+
+

You will learnHow add, subtract, negate and compare work on 9-trit registers.

The ALU of this widget is built from the course so far: ADD is the ripple adder, SUB adds b with every trit flipped, NEG is the flip alone, CMP answers one trit. Nine-trit registers hold -9841 to 9841, and a result beyond that is flagged as overflow. The lesson spec, tri27_machine.t27, states the TRI-27 machine as the Trinity emulator executes it.

Try it

Subtract 13 from 40 and read the tiles; then make the adder overflow with the smallest pair you can.

+
A ternary ALU built from this course's addersThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/isa/tri27_machine.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

A three-way jump

+
+

You will learnWhy one ternary compare can branch three ways.

A binary machine branches on a flag: to tell less, equal and greater apart it tests twice. A ternary compare answers with one trit, so one instruction can jump three ways. The widget compares a and b at their first differing trit, lit gold, and takes the matching target. The machine of the next lesson ends its loops with exactly this jump.

Try it

Make the jump take each of the three targets; then find two numbers that differ only in their lowest trit.

+
A three-way jump: one compare, three targetsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

Run a program

+
+

You will learnHow five instructions and one three-way jump make a loop that ends itself.

The widget's machine has three 9-trit registers and five instructions: SET, ADD, DEC, BR3 and HALT. Sum 1..n sets r1 to n, adds it into r0, decrements, and BR3 jumps back while r1 is positive; at 0 it falls through to HALT. For n = 5 it halts with r0 = 15. The lesson spec describes the .tbin container a TRI-27 program ships in, as the Trinity loader reads it.

Try it

Step the sum program clock by clock for n = 3; then run 7 x n for n = 12 and count the clocks.

+
Run a program on a ternary machineThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/isa/tri27_bytecode.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · Three answers

Compare at the highest differing trit, find a number in thirds, sort with three-way compares.

+
+
22

Lesson 22 of 27

Compare at the top

+
+

You will learnWhy balanced-ternary numbers compare at their first differing trit.

In balanced ternary the trits below place i add up to less than half of 3^i, so the highest differing trit decides any comparison. 41 is +---- and 39 is 0+++0: they differ in the top trit, so 41 is greater although its tiles show four minus signs. The spec's compare() reads that trit and is checked against plain less and greater on 714 pairs.

Try it

Find two numbers that first differ in their lowest trit, and two that differ in every trit.

+
Compare at the first differing tritThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

Questions in thirds

+
+

You will learnWhy three-answer questions find a number faster, and spell it as they go.

Ask which third of the range a hidden number lies in, and each answer is one of three: low, middle, high. Over the range -121..121 the answers, from the top, are exactly the number's five trits. Among 243 numbers that takes 5 questions; yes-or-no questions need 8. The spec's questions3() and questions2() count both.

Try it

Hide 23 and ask until it is found; then hide -121 and say what every answer was.

+
Twenty questions in thirdsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

Sort with three-way compares

+
+

You will learnHow a sort uses compares that also answer equal.

Three compares sort three numbers: the left pair, the right pair, then the left pair again. Each compare answers less, equal or greater in one go, so two equal sevens are settled by a single compare and never swapped. Sorting with ties then needs no extra test.

Try it

Sort 7, -2, 7; then find an order of three different numbers that needs no swap at all.

+
Sort three numbers with three-way comparesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · Ternary neurons

Weights of -1, 0, +1: one neuron, a detector and a small layer, with no multiplier anywhere.

+
+
25

Lesson 25 of 27

One ternary neuron

+
+

You will learnHow a neuron with weights -1, 0, +1 computes without multiplying.

A neuron multiplies each input by a weight, adds the products and compares the sum with a threshold. With ternary weights every product is a copy, a zero or a flip, so the sum is adds and subtracts only. The spec's activate() answers +1 at or above the threshold, -1 at or below minus it and 0 between: a neuron that can say not sure.

Try it

Draw a vertical bar on the input and raise the threshold until the neuron stops firing; then press weights until it fires on a horizontal bar.

+
One ternary neuron: inputs, weights, a thresholdThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/trits.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

A bar detector

+
+

You will learnWhy a neuron's weights work as a template.

Give the neuron the weights of a vertical bar and its sum counts agreements minus disagreements with them. The vertical bar sums to 9 and fires +1, the inverted bar sums to -9 and fires -1, the horizontal bar and the diagonal sum to 1 and noise to 0. The lesson spec is the same neuron in hardware: a combinational BitNet neuron over one 27-trit chunk.

Try it

Edit the input until the sum is exactly the threshold 5; then find the smallest change to the vertical bar that stops it firing.

+
A bar detector: one neuron, four patternsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/comb_bitnet_neuron.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

A tiny layer

+
+

You will learnHow several neurons reading one input describe it with a few trits.

A layer is several neurons that read the same input. Three detectors, vertical, horizontal and diagonal, turn a 3 x 3 picture into three output trits: a vertical bar gives +1, 0, 0. Stack layers and you have a network; the lesson spec is a 4-neuron layer in one combinational module, and the ai-numbers course takes it to a whole network on the board.

Try it

Draw a picture that makes two neurons fire at once; then one that makes all three answer -1.

+
A layer of three ternary neuronsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/ternary/comb_bitnet_layer.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · Three values
    1. 01 Why three
    2. 02 Balanced ternary
    3. 03 Flip to negate, cut to round
  2. 02 · Logic with unknown
    1. 04 Three-valued logic
    2. 05 Consensus and any
    3. 06 Sum and carry
  3. 03 · Adding trits
    1. 07 The half adder
    2. 08 The full adder
    3. 09 Ripple carry
  4. 04 · Multiplying without a multiplier
    1. 10 Times one trit
    2. 11 Long multiplication
    3. 12 A ternary MAC
  5. 05 · Trits in binary memory
    1. 13 Two bits per trit
    2. 14 Five trits in a byte
    3. 15 A word of 27 trits
  6. 06 · The TRI-27 instruction word
    1. 16 The instruction word
    2. 17 The opcode map
    3. 18 The immediate
  7. 07 · A ternary machine
    1. 19 A ternary ALU
    2. 20 A three-way jump
    3. 21 Run a program
  8. 08 · Three answers
    1. 22 Compare at the top
    2. 23 Questions in thirds
    3. 24 Sort with three-way compares
  9. 09 · Ternary neurons
    1. 25 One ternary neuron
    2. 26 A bar detector
    3. 27 A tiny layer
+ + + + + diff --git a/apps/website/public/learn/ternary-computing/index.html b/apps/website/public/learn/ternary-computing/index.html index 3595b8a3ee..819cea8aac 100644 --- a/apps/website/public/learn/ternary-computing/index.html +++ b/apps/website/public/learn/ternary-computing/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

The ternary machine: from a trit to a running program

Every lesson is something to press. Each widget runs the fn bodies of a t27 spec compiled to WebAssembly, so the trits you see are the spec computing, beside the spec you can open in the player.

Course 8, 27 lessons, a live widget and a t27 spec in each: why three, balanced ternary, three-valued logic, adders, multiplying without a multiplier, trits in binary memory, the TRI-27 instruction word, a ternary machine and ternary neurons. Every number on a widget is computed by a compiled t27 spec.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/ternary-mac/index.html b/apps/website/public/learn/ternary-mac/index.html index 00467e2187..fbc088b0f5 100644 --- a/apps/website/public/learn/ternary-mac/index.html +++ b/apps/website/public/learn/ternary-mac/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A ternary MAC

You will learn

How a dot product with ternary weights becomes adds, subtracts and skips.

A multiply-accumulate unit adds input times weight, clock after clock. With weights of -1, 0 and +1 each clock is an add, a subtract or nothing: the widget's nine clocks make 4 adds, 2 subtracts and 3 skips and land on -8, with no multiplier. The lesson spec, ternary_mac.t27, is the hardware version: a 27-trit dot product over packed vectors, 2 bits per trit.

Try it

Press weights until the accumulator lands on 0, then on the largest value you can reach.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A MAC with ternary weights: add, subtract or skip
A MAC with ternary weights: add, subtract or skip ↗

Nine inputs, nine weights of -1, 0 or +1. Each clock the accumulator adds, subtracts or does nothing. Press a weight to change it.

specs/ternary/ternary_mac.t27

module TernaryMac;
@@ -113,6 +145,7 @@ 

A ternary MAC

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/test-strength/index.html b/apps/website/public/learn/test-strength/index.html index bef991f976..7655d7592c 100644 --- a/apps/website/public/learn/test-strength/index.html +++ b/apps/website/public/learn/test-strength/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Test strength

You will learn

How to measure a suite, not admire it: caught mutants, deleted tests, vacuous passes.

Coverage says what you ran; mutation says what your running is worth. A suite's strength is its kill count on faults you chose, its behavior when tests are deleted, its share of passes that executed an assert. The widget is the reference side of that measuring: all 6 reference bitstreams present and read -- 84.4 ms, best of 5 -- so a speed or strength number always stands on a reference somebody pinned. Measure the suite, or admit you are admiring it.

Try it

Measure one thing twice, two ways, in the refs widget's style; then say which of your own suite's numbers has no denominator.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri x7-part · x7-refs · x7-bench: the references the bitstream path is checked on
tri x7-part · x7-refs · x7-bench: the references the bitstream path is checked on ↗

The part table in far.t27 matches prjxray-db part.json, all 6 reference bitstreams are present, and bitwalk reads all 6 in 84.4 ms (best of 5).

specs/tools/trios/tri/x7-mutate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Test strength

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/tests-are-the-spec/index.html b/apps/website/public/learn/tests-are-the-spec/index.html index 0627155ef4..e102610389 100644 --- a/apps/website/public/learn/tests-are-the-spec/index.html +++ b/apps/website/public/learn/tests-are-the-spec/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Tests are part of the spec

You will learn

Why every t27 spec carries its own tests, and what a waveform shows.

In t27 a spec is not finished without its claims: test blocks, invariants and benches live in the same file as the code they check, and the compiler refuses a spec with none. A test can also be run as gates in a simulator. The waves below are a real simulation of Verilog generated from a ternary multiply-accumulate spec, driven by that spec's own test vectors.

Try it

Zoom into one clock cycle and read the values on the buses at a pass mark.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Test waves: a t27 spec's tests, simulated and drawn as waves
Test waves: a t27 spec's tests, simulated and drawn as waves ↗

Verilog generated from a ternary MAC spec, driven by the spec's own test vectors under Icarus Verilog: clock, buses, pass marks. Drop a .vcd and it draws yours.

specs/tutorial/07_tests_invariants_benches.t27

// SPDX-License-Identifier: Apache-2.0
@@ -154,6 +186,7 @@ 

Tests are part of the spec

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-butterfly/index.html b/apps/website/public/learn/the-butterfly/index.html index 8abf3b3fca..9ea018c449 100644 --- a/apps/website/public/learn/the-butterfly/index.html +++ b/apps/website/public/learn/the-butterfly/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The butterfly

You will learn

How a radix-2 FFT breaks a DFT into stages of butterflies, and what that saves.

A butterfly takes a and b, multiplies b by a twiddle W and outputs a + Wb and a - Wb. A radix-2 FFT of N points is log2 N stages of N/2 of them: 3 stages of 4 butterflies at 8 points, 5120 butterflies at 1024 points against 1048576 multiplies for a direct DFT. The widget runs the integer FFT of the spec and shows every value: one cycle of cosine at 8 points comes out at 509 in bins 1 and 7. The spec signals.t27 computes every butterfly.

Try it

Light each stage of the 8-point FFT in turn and count the twiddles it uses; then find the stage where the value of the DC input doubles.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The FFT butterfly: N log N instead of N^2
The FFT butterfly: N log N instead of N^2 ↗

Pick a size, an input and a stage. See every butterfly pair, its twiddle on the unit circle and the values flowing through, and count the work against a direct DFT.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

The butterfly

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-carry-chain/index.html b/apps/website/public/learn/the-carry-chain/index.html index 026dd4c188..fd5c73187c 100644 --- a/apps/website/public/learn/the-carry-chain/index.html +++ b/apps/website/public/learn/the-carry-chain/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The carry chain

You will learn

Why a carry walks the whole word, and how the dedicated chain of a slice makes the walk cheap.

Bit i of a + b is the XOR of a_i, b_i and the carry into it, and the carry out is their majority. A carry made at bit 0 of 127 + 1 has to pass through bits 1 to 6 before the top bit knows its answer: the widget lights that run of 7. Recomputing the carry in a LUT costs a LUT and a route per bit; the dedicated chain of a 7-series slice costs one LUT and one route, then one hop per bit, in CARRY4 blocks of 4 bits. The spec adders.t27 states both models and leaves the three delays to you.

Try it

Load 127 + 1 and find the longest carry run; then switch to 85 + 170 and explain why the run is 0. Set the hop to 30 ps and compare the two delays for 32 bits.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The carry chain: why adding is slow, and how a slice makes it fast
The carry chain: why adding is slow, and how a slice makes it fast ↗

Tap the bits of two numbers and watch the carry run up the word. Then set three delays and see what the dedicated carry chain saves over LUTs.

specs/fpga/dsp/adders.t27

// SPDX-License-Identifier: Apache-2.0
@@ -552,6 +584,7 @@ 

The carry chain

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-cic-filter/index.html b/apps/website/public/learn/the-cic-filter/index.html index d5a021f417..5241083205 100644 --- a/apps/website/public/learn/the-cic-filter/index.html +++ b/apps/website/public/learn/the-cic-filter/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The CIC filter

You will learn

How a CIC decimator filters with no multipliers, and how many bits its registers must grow.

A CIC decimator is N integrators at the input rate, a rate change of R and N combs with delay M at the output rate. Its DC gain is (RM)^N, so its registers grow ceil(N log2(RM)) bits: with N = 4, R = 8 and M = 1 that is 4096 and 12 bits, a 16-bit input in 28-bit registers. Its response has a null at every multiple of the output rate and droops 3.6 dB at a quarter of it. The spec signals.t27 computes the gain, the growth and the response.

Try it

Set one stage and compare the response with the moving average; then load the last preset and count the register bits.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The CIC filter: no multipliers, many bits
The CIC filter: no multipliers, many bits ↗

Set stages, rate change, delay and input width. See the sinc-shaped response with its nulls, and how many bits every register has to grow.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

The CIC filter

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-comb-answers/index.html b/apps/website/public/learn/the-comb-answers/index.html index 529394bc39..a3279a65bd 100644 --- a/apps/website/public/learn/the-comb-answers/index.html +++ b/apps/website/public/learn/the-comb-answers/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The comb answers

You will learn

How the game shows that something happened to a task, and how often the map grows.

The game's comb has a cell for each issue, and before hive.t27 an accepted task, a lost lease and a cancel looked the same as no news. cell_effect gives each of the 10 event kinds its paint: a start white, an accepting review gold, a send-back amber, a lost lease red, a cancel grey. flash_alpha fades it over FLASH_MS, 1800 ms. A new cell rebuilds the scene, so cells_due places new cells in batches at most every 300 s.

Try it

Tap the review cell and switch the verdict; then find the moment the flash is gone.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The comb answers: what an event does to a cell
The comb answers: what an event does to a cell ↗

Ten kinds of event reach the game. Pick one and the moment since: cell_effect colours the cell gold, amber, red, grey or white, flash_alpha fades it, and cells_due batches new cells.

specs/queen/hive.t27

// SPDX-License-Identifier: Apache-2.0
@@ -252,6 +284,7 @@ 

The comb answers

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-dsp48e1-slice/index.html b/apps/website/public/learn/the-dsp48e1-slice/index.html index 3fa3b7c904..1cc7afe4b9 100644 --- a/apps/website/public/learn/the-dsp48e1-slice/index.html +++ b/apps/website/public/learn/the-dsp48e1-slice/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The DSP48E1 slice

You will learn

How a product is tiled onto 25 x 18 multipliers and how many terms the 48-bit accumulator can sum.

A DSP48E1 slice multiplies a 25-bit by an 18-bit two's complement number into a 48-bit accumulator, and the XC7A200T has 740 of them. A 25 x 18 product needs 43 bits, so the accumulator keeps 5 bits of headroom: 32 terms sum safely and the 33rd can overflow. A wider product is cut into pieces, the low ones one bit short of the port because they are unsigned: 32 x 32 takes 4 slices. The spec multipliers.t27 holds the tiling, the guard bits and the headroom.

Try it

Find the widest b that still fits one slice next to a 25-bit a; then set 16 x 16 and find the largest number of terms the accumulator holds.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The DSP48E1 slice: fit a x b and its running sum
The DSP48E1 slice: fit a x b and its running sum ↗

Set two operand widths and a number of terms. See how many 25 x 18 slices the product takes and whether the 48-bit accumulator has room for the sum.

specs/fpga/dsp/multipliers.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

The DSP48E1 slice

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-frame/index.html b/apps/website/public/learn/the-frame/index.html index fd5985ab61..ee3fc60b3a 100644 --- a/apps/website/public/learn/the-frame/index.html +++ b/apps/website/public/learn/the-frame/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The frame: start, data, stop

You will learn

How a UART frame is built bit by bit, and what the compiler emits for it.

A UART frame is the atoms of the bus: the line idles high, a start bit pulls it low, eight data bits follow, and a stop bit returns it high. The testbench spec of the last lesson of this module checks the idle itself -- uart_tb_tx_idle_high and uart_tb_rx_idle_high are two of its seven tests. The recording shows the compiler lowering the spec to synthesizable Verilog: the module ZeroDSP_UART, its clk, rst_n, en, data and ready ports, the datapath as wires.

Try it

In the recording, find the module name and its ports; then in the spec frame find the width and depth constants of the frame and the FIFO.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on uart.t27 -- spec to RTL
t27c gen-verilog on uart.t27 -- spec to RTL ↗

The compiler lowers the UART spec to synthesizable Verilog: the TRINITY banner, the module port list and the datapath as wires.

specs/fpga/uart.t27

// SPDX-License-Identifier: Apache-2.0
@@ -297,6 +329,7 @@ 

The frame: start, data, stop

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-huber-loss/index.html b/apps/website/public/learn/the-huber-loss/index.html index 85131d12a3..487c33e106 100644 --- a/apps/website/public/learn/the-huber-loss/index.html +++ b/apps/website/public/learn/the-huber-loss/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The Huber loss

You will learn

How the Huber loss treats a small error like squared error and a large one linearly, so outliers pull less.

Squared error lets one outlier dominate: an error of 3 costs 4.5 as half its square, as much as 36 errors of 0.5. Huber is half the square while |e| is within delta and then grows only linearly, delta |e| - delta^2 / 2, so with delta 1 that error costs 2.5. The two pieces meet with the same value and slope, and the gradient never grows past delta: a far-off point pulls on the model with a bounded force. For the spec's pair of errors 0.5 and 3 the mean is 1.3125, against 2.3125 for half the square. The spec huber_loss.t27 computes both.

Try it

Set delta to 0.5 and drag the error to 3; then find where the two curves part.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Huber loss: a loss that does not panic at an outlier
Huber loss: a loss that does not panic at an outlier ↗

Drag the error along: Huber is half its square inside delta and only grows linearly outside, so one wild miss pulls on the model with a bounded force. The dashed curve is the pure square.

specs/ml/loss/huber_loss.t27

// SPDX-License-Identifier: Apache-2.0
@@ -162,6 +194,7 @@ 

The Huber loss

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-immediate/index.html b/apps/website/public/learn/the-immediate/index.html index c0b8240d3a..fc65441189 100644 --- a/apps/website/public/learn/the-immediate/index.html +++ b/apps/website/public/learn/the-immediate/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The immediate

You will learn

How a 15-bit signed immediate is clamped, stored and read back.

An immediate lives in 15 bits of two's complement: -16384 to 16383. The spec clamps anything outside to the edge rather than wrapping it, so 20000 becomes 16383, and the field round-trips through encode and decode. The lesson spec is the t27a assembler and disassembler, which write and read the same table both ways.

Try it

Try 16383, 16384 and -16385; then find the immediate whose 15 bits are all ones.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The immediate: fifteen bits, clamped, and read back
The immediate: fifteen bits, clamped, and read back ↗

An immediate lives in 15 bits of two's complement, -16384 to 16383. Push it past the edge and watch it clamp, then decode the word back.

specs/isa/t27a.t27

// SPDX-License-Identifier: Apache-2.0
@@ -762,6 +794,7 @@ 

The immediate

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-instruction-word/index.html b/apps/website/public/learn/the-instruction-word/index.html index 336203a94a..6d990158c3 100644 --- a/apps/website/public/learn/the-instruction-word/index.html +++ b/apps/website/public/learn/the-instruction-word/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The instruction word

You will learn

How the TRI-27 emulator packs an instruction into 32 bits.

The TRI-27 machine computes with trits, but its instructions are 32-bit binary words, decoded by the pinned Trinity emulator. The opcode sits in bits 7..0, the destination register in 12..8, the sources above it; the immediate form gives the top 15 bits to a signed number. The widget calls the spec's encode() and reads every field back with opcode_of(), dst_of() and the rest.

Try it

Encode ADD r1, r2, r3 and LDI r1 with 5; say which bits differ and why the immediate form has a narrower src1.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The TRI-27 instruction word, field by field
The TRI-27 instruction word, field by field ↗

Pick an instruction and its registers. The emulator packs them into a 32-bit word: opcode, destination, sources or an immediate.

specs/isa/ternary_encoding.t27

// SPDX-License-Identifier: Apache-2.0
@@ -546,6 +578,7 @@ 

The instruction word

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-merge-gate/index.html b/apps/website/public/learn/the-merge-gate/index.html index 89e9554f9d..2add17438f 100644 --- a/apps/website/public/learn/the-merge-gate/index.html +++ b/apps/website/public/learn/the-merge-gate/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The merge gate

You will learn

When the merger may merge a pull request a reviewer bee approved.

The reviewer bee approves, and the merger merges; merger_gate.t27 is the rule between them. check_passes lets a green check through and blocks any check still running. A red one passes only when it is not required, has concluded, and the bee named it as discounted, and with the ruleset unreadable every check counts as required. gate_open needs at least 1 posted check, 0 running and 0 blocking: zero checks is not zero failures.

Try it

Let the running check conclude green; then make the ruleset unreadable and watch the discounted red.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The merge gate: when an approved pull request may merge
The merge gate: when an approved pull request may merge ↗

Four checks on a pull request the reviewer bee approved. Tap what each one is: check_passes judges it, and gate_open opens only when one has posted, none runs and none blocks.

specs/queen/merger_gate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

The merge gate

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-module-line/index.html b/apps/website/public/learn/the-module-line/index.html index 51695e095e..c895bacbb1 100644 --- a/apps/website/public/learn/the-module-line/index.html +++ b/apps/website/public/learn/the-module-line/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The module line

You will learn

How to write the module line, which names it accepts, and where it goes.

The module line is the keyword module, a name and a semicolon. Comment and prose lines may come before it; declarations come after. Names use letters, digits and underscores; the compiler in this site also accepts hyphens, as in tutorial-06-structs. A course spec on this site must use the module name its generator expects, so a wrong name is caught by the build and not by the compiler.

Try it

In the player, change the module name of this lesson spec and watch the verdict stay clean.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 2: the module line
t27 basics 2: the module line ↗

Which module lines the t27c compiler accepts, checked in the browser with the real compiler. Lesson 2 of the t27 basics course.

specs/basics/02_the_module_line.t27

// SPDX-License-Identifier: Apache-2.0
@@ -79,6 +111,7 @@ 

The module line

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-moving-average/index.html b/apps/website/public/learn/the-moving-average/index.html index f6344b4860..2a328bba7c 100644 --- a/apps/website/public/learn/the-moving-average/index.html +++ b/apps/website/public/learn/the-moving-average/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The moving average

You will learn

Why averaging L samples is a low-pass filter, and where its nulls fall.

Average the last L samples and a tone at f comes out multiplied by |sin(pi f L) / (L sin(pi f))|. For L = 4 that is 1 at DC, 0.65328 at 1/8 of the sample rate and exactly 0 at 1/4: every multiple of 1/L is a null. It needs no multiplier at all, which is why FPGA designs reach for it early. The spec signals.t27 computes the response and the output sample by sample.

Try it

Put the tone on the null of L = 4 and watch the output vanish; then double L and find the new null.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The moving average: a low-pass you can do in your head
The moving average: a low-pass you can do in your head ↗

Set how many samples to average and pick a tone. See the response, its nulls at multiples of 1/L, and the tone coming out smaller by exactly that much.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

The moving average

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-nco/index.html b/apps/website/public/learn/the-nco/index.html index 0f77992529..cf17b4b521 100644 --- a/apps/website/public/learn/the-nco/index.html +++ b/apps/website/public/learn/the-nco/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A numerically controlled oscillator

You will learn

How a phase accumulator and a sine table make any frequency, and how fine the steps are.

Add a tuning word M to an N-bit accumulator every clock and its top bits sweep around a circle at f_out = M f_clk / 2^N. At 100 MHz with N = 32, M = 2^30 gives 25 MHz, a quarter turn per clock, and the next frequency up is 0.0233 Hz away. The top P bits of the phase address a sine table; the rule of thumb puts the worst phase-truncation spur about 6.02 dB per kept bit below the carrier. The spec signals.t27 picks M and computes every sample.

Try it

Ask for 1 MHz and read the tuning word and the frequency you actually get; then cut the table to 4 phase bits and look at the output samples.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The NCO: a phase accumulator and a sine table
The NCO: a phase accumulator and a sine table ↗

Set a clock, an accumulator width and a frequency. The spec picks the tuning word; watch the phase step around the wheel and the table turn it into a sine.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

A numerically controlled oscillator

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-next-key/index.html b/apps/website/public/learn/the-next-key/index.html index d4b63f0b88..fba4a5ec8d 100644 --- a/apps/website/public/learn/the-next-key/index.html +++ b/apps/website/public/learn/the-next-key/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The next key

You will learn

Which key a bee tries next, and when it moves to another pool or gives up.

On 2026-10-17 a bee started on key 9 of 10 and died 7 s later while 33 other keys stood by: it got one key at dispatch and kept it. next_free now picks the next key after the last one that is neither tried nor resting. 1305 is an overload of the pool's model, so once POOL_OVERLOAD_KEYS, 3, keys said it within a minute, step moves the bee to the next pool. After 8 attempts the turn ends.

Try it

Mark key 2 as tried and see which key gets the ring; then set three keys that said 1305.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The next key: a bee moves on instead of dying
The next key: a bee moves on instead of dying ↗

A pool of keys, some tried, some resting. Tap keys to change them: next_free picks the next one after the last, and step says next key, next pool or give up.

specs/queen/key_failover.t27

// SPDX-License-Identifier: Apache-2.0
@@ -451,6 +483,7 @@ 

The next key

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-night-watch/index.html b/apps/website/public/learn/the-night-watch/index.html index 62c1077f6c..98271af979 100644 --- a/apps/website/public/learn/the-night-watch/index.html +++ b/apps/website/public/learn/the-night-watch/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The night watch

You will learn

What the night watch does in the morning with four card checks.

Every night four checks of the card chat run: the thread, the status door, the merges and the parity. night_verdict sums them up: any fail is a fail, else anything unmeasured is unmeasured, else it is a pass. night_report turns that into one act: a fail opens an issue or comments on the open one, a pass closes an open issue or stays silent, and an unmeasured night leaves everything as it is.

Try it

Make the night pass with the issue open; then make one check unmeasured.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The night watch: four checks, one verdict, one report
The night watch: four checks, one verdict, one report ↗

Every night four card checks run. Tap each to pass, fail or unmeasured: night_verdict sums them up and night_report says whether to open an issue, comment, close it or stay silent.

specs/automation/card-chat-night-watch.t27

// SPDX-License-Identifier: Apache-2.0
@@ -213,6 +245,7 @@ 

The night watch

}

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-opcode-map/index.html b/apps/website/public/learn/the-opcode-map/index.html index c4193049ea..05fab77698 100644 --- a/apps/website/public/learn/the-opcode-map/index.html +++ b/apps/website/public/learn/the-opcode-map/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The opcode map

You will learn

Which of the 256 opcode bytes mean something, and what the rest do.

Of 256 byte values, 47 are TRI-27 opcodes, from NOP and LD through ADD, JMP and HALT to SYSCALL. The other 209 are not errors to the emulator: decode_opcode() reads an unknown byte as NOP, so decoding never fails. The lesson spec, t27a_mnemonics.t27, gives the t27a assembler a strict decoder that refuses those bytes instead.

Try it

Find the opcode bytes of ADD and HALT; then press an unlit byte and say why a strict decoder is safer for an assembler.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The opcode map: 47 of 256 bytes mean something
The opcode map: 47 of 256 bytes mean something ↗

Every byte from 0 to 255 as a cell; green ones are TRI-27 opcodes. Press a byte: an undefined one decodes as NOP, decoding never fails.

specs/isa/t27a_mnemonics.t27

// SPDX-License-Identifier: Apache-2.0
@@ -302,6 +334,7 @@ 

The opcode map

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-packet-bridge/index.html b/apps/website/public/learn/the-packet-bridge/index.html index 410e088b29..33779a7fd6 100644 --- a/apps/website/public/learn/the-packet-bridge/index.html +++ b/apps/website/public/learn/the-packet-bridge/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The packet bridge

You will learn

How the packet bridge moves work between buses, and what its buffers cost.

The packet bridge moves work between buses as packets: RX and TX buffers of 256 bytes each, an SPI buffer of 64, MAX_PACKET_SIZE 128, PACKET_TIMEOUT 10,000 cycles, and opcodes OP_MAC_MUL, OP_MAC_MAC and OP_MAC_MACC for the work it carries. bridge_buffer_count_wrap and bridge_buffer_count_wrap2 check the arithmetic at the seam. The recording lowers the bridge spec to synthesizable Verilog.

Try it

In the recording, find the module ports of the bridge; then in the spec frame find the four buffer constants and the timeout, and the three opcodes.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen-verilog on bridge.t27 -- spec to RTL
t27c gen-verilog on bridge.t27 -- spec to RTL ↗

The bus bridge spec lowered to synthesizable Verilog: both sides of the crossing as generated wires.

specs/fpga/bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -591,6 +623,7 @@ 

The packet bridge

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-prescaler-ladder/index.html b/apps/website/public/learn/the-prescaler-ladder/index.html index 9cde30bb4b..37e8e1c78d 100644 --- a/apps/website/public/learn/the-prescaler-ladder/index.html +++ b/apps/website/public/learn/the-prescaler-ladder/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The prescaler ladder

You will learn

How the prescaler ladder turns one clock into a family of SCK rates, and which steps are valid.

One clock becomes a family of rates through the prescaler ladder: PRESCALER_2 is 0, PRESCALER_4 is 1, and the ladder climbs while the clock holds. spi_prescaler_16_default checks the default, spi_set_prescaler_valid and spi_set_prescaler_invalid check the bounds, spi_sck_freq_at_50 checks the arithmetic. The recording is a native run: the SPI testbench spec through the real t27c, 7 tests pass.

Try it

In the recording, count the passing tests; then in the spec frame list the prescaler constants and find the test that checks the default.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on spi_tb.t27 -- simulating the SPI testbench
t27c on spi_tb.t27 -- simulating the SPI testbench ↗

t27c test-report on the SPI testbench spec: 7 tests pass natively -- the bench drives the modes and checks the captures.

specs/fpga/testbench/spi_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

The prescaler ladder

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-public-board/index.html b/apps/website/public/learn/the-public-board/index.html index a0cae99082..895d78eab9 100644 --- a/apps/website/public/learn/the-public-board/index.html +++ b/apps/website/public/learn/the-public-board/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The public board

You will learn

Which column the public board draws each claim in, and the case it gets wrong.

The board at app.t27.ai/game/kanban draws every dispatch in one of 6 columns. column_of reads the claim a dispatch holds on its issue: running is running, accepted is done, rejected and awaiting review are in review, and failed is dropped. dispatch.t27 records one finding as it is: once an issue is closed and the list was read, every finished claim is drawn as done, whatever its verdict.

Try it

Open the issue and see where the four finished claims go; then say what a closed issue hides.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The public board: which column a task's card is in
The public board: which column a task's card is in ↗

Five claims a dispatch can hold on its issue. Close the issue: column_of moves every finished one to done, whatever its verdict.

specs/queen/dispatch.t27

// SPDX-License-Identifier: Apache-2.0
@@ -662,6 +694,7 @@ 

The public board

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-queens-move/index.html b/apps/website/public/learn/the-queens-move/index.html index 5f9f35dc9f..316d34da68 100644 --- a/apps/website/public/learn/the-queens-move/index.html +++ b/apps/website/public/learn/the-queens-move/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The Queen's move

You will learn

What the Queen does for each jam, and which jams she waits on.

Each case has one action at the same position: no reviewer dispatches a reviewer, refused not fixed dispatches the coder, refused then pushed dispatches a re-review, and labeled not merged finishes the merge. jam_action maps any value above 9 to measure again, so an unknown case is never nothing to do. jam_is_queens_turn is false for 3 cases, none, draft or fresh, and stacked on an open PR: she waits on those.

Try it

Find the case whose action is wait for the base; then drag to 200 and read the action.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The Queen's move: what each jam asks of her
The Queen's move: what each jam asks of her ↗

Each jam case has one action at the same position. Drag the case: jam_action names the move, and jam_is_queens_turn splits the board into her turn and waiting.

specs/automation/review-jam.t27

// Review jam: which case a stuck pull request is in, and the Queen's action.
@@ -342,6 +374,7 @@ 

The Queen's move

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-queue/index.html b/apps/website/public/learn/the-queue/index.html index ae4399f359..e97fb74896 100644 --- a/apps/website/public/learn/the-queue/index.html +++ b/apps/website/public/learn/the-queue/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The queue

You will learn

How the cap, aging and blockers order a queue of open issues.

Labels inflate: if every issue is critical, none is. capped_level lets at most CRITICAL_CAP, 3, issues of a listing run as critical, taken in listing order, and the 4th runs as high. An issue with an open blocker is skipped, not waited on, so it cannot hold up the queue. outranks compares the effective level, then the real level, then the place in the listing, so an aged issue never beats a real one of its level. why names the reason for each place.

Try it

Make a fifth issue critical and see where it lands; then label the unlabelled issue low.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The queue: which issue the Queen takes first
The queue: which issue the Queen takes first ↗

Seven open issues in GitHub order. Tap one to change its label: the cap, aging, blockers and outranks reorder the queue, and each issue says why it sits there.

specs/queen/priority.t27

// SPDX-License-Identifier: Apache-2.0
@@ -231,6 +263,7 @@ 

The queue

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-review-jam/index.html b/apps/website/public/learn/the-review-jam/index.html index 0ed55cb082..69a9dc64a7 100644 --- a/apps/website/public/learn/the-review-jam/index.html +++ b/apps/website/public/learn/the-review-jam/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The review jam

You will learn

Which of ten cases a stuck pull request is in, and why the earliest matching rule wins.

A pull request can stall for many reasons at once: refused, pushed again, and red on a noise check. review-jam.t27 gives the Queen one answer. jam_case checks 9 facts in a fixed order and the earliest rule that matches wins, so a PR the Queen could not measure is never reported as free, and one that was refused and then pushed is not taken for noise. There are 10 cases, from none to unmeasured.

Try it

Clear facts one by one from the start state and name each case you pass; then find a PR that is in no jam.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The review jam: which case a stuck pull request is in
The review jam: which case a stuck pull request is in ↗

Nine facts about a pull request that will not move. Toggle them: the earliest rule that matches wins, and the pull request lands on that rule.

specs/automation/review-jam.t27

// Review jam: which case a stuck pull request is in, and the Queen's action.
@@ -342,6 +374,7 @@ 

The review jam

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-ship-flies-home/index.html b/apps/website/public/learn/the-ship-flies-home/index.html index 5f922d11d6..fc46ff9b2f 100644 --- a/apps/website/public/learn/the-ship-flies-home/index.html +++ b/apps/website/public/learn/the-ship-flies-home/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The ship flies home

You will learn

Where the game draws a bee for each thing it is doing, and how a finished task ends on screen.

In the game at app.t27.ai/game each bee is a ship over the issue it works on. ship_mode in hive.t27 picks the place: parked at the entrance before a runner claims it, orbiting its cell while it is heard from, hovering when it has gone quiet, and waiting at its repository's portal until its cell is placed. When the bee leaves the feed it flies home, and ship_alpha fades it over DEPART_MS, 2400 ms: at 1200 ms it is at 500 of 1000.

Try it

Mark the bee as not heard from and see where it moves; then drag the time past 2400 ms.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The game: where a bee flies and how it leaves
The game: where a bee flies and how it leaves ↗

Set what the bee is doing and where its cell stands: ship_mode puts it at the entrance, the portal, its cell or on the way home, and ship_alpha fades it out.

specs/queen/hive.t27

// SPDX-License-Identifier: Apache-2.0
@@ -252,6 +284,7 @@ 

The ship flies home

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/the-sigmoid/index.html b/apps/website/public/learn/the-sigmoid/index.html index 79977d8eed..95f19a3ccd 100644 --- a/apps/website/public/learn/the-sigmoid/index.html +++ b/apps/website/public/learn/the-sigmoid/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The sigmoid: a number into a probability

You will learn

How the sigmoid maps any input to a probability, and why its slope limits deep networks.

The sigmoid 1 / (1 + e^-x) squeezes the whole number line into 0 to 1, which is why it reads as a probability: 2 becomes 0.8808 and -4 becomes 0.018. Its slope is s (1 - s), computed from the output s itself, and it is largest at 0, where it is 0.25; at x = 8 it is 0.000335. A gradient that passes back through a stack of sigmoids is multiplied by at most 0.25 at each one, which is why deep sigmoid networks trained slowly. The spec sigmoid_activation.t27 computes the curve and the slope.

Try it

Find the input where the probability is 0.5; then drag to 6 and read how little slope is left.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Sigmoid: turn any number into a probability
Sigmoid: turn any number into a probability ↗

Drag along the S-curve: every input lands between 0 and 1, and the slope peaks at 0.25 in the middle and dies away at both ends.

specs/ml/activation/sigmoid_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -164,6 +196,7 @@ 

The sigmoid: a number into a probability

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/three-bots-deep/index.html b/apps/website/public/learn/three-bots-deep/index.html index 8ab941ff88..cc25745db0 100644 --- a/apps/website/public/learn/three-bots-deep/index.html +++ b/apps/website/public/learn/three-bots-deep/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Three bots deep

You will learn

How the hive stops agents from answering each other forever.

Telegram gives no loop protection between bots, so two agents could answer each other forever. Two numbers stop it. MAX_BOT_DEPTH is 3: a person, then A, B and C, then silence. BOT_REPLY_COOLDOWN_MS is 5000: a bot answers another bot at most once in 5 s. may_answer always lets a person through, and a bot only inside the chain and after the cooldown.

Try it

Find the gap at which agent B falls silent; then explain why C is silent too.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Chain depth: human, A, B, C, then silence
Chain depth: human, A, B, C, then silence ↗

One person asks; agents answer each other. Drag the pause between bot messages: may_answer lets the chain run three bot messages deep and then stops it.

specs/automation/agent-hive-group.t27

// SPDX-License-Identifier: Apache-2.0
@@ -429,6 +461,7 @@ 

Three bots deep

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/three-way-agreement/index.html b/apps/website/public/learn/three-way-agreement/index.html index 4530ce5957..980045ca6a 100644 --- a/apps/website/public/learn/three-way-agreement/index.html +++ b/apps/website/public/learn/three-way-agreement/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Three-way agreement

You will learn

How spec, simulator and board are held to one answer, and what each one is trusted for.

Three answers, one question. The spec says what should happen; the simulator says what a model of the silicon does; the board says what the silicon does. The widget is the rehearsal for that agreement with the board taken out of the loop: 26 checks, no board, no RTL -- a clean link returns every receipt with no retransmit, 11 loss and fault cases recover, and a lie, a duplicate or a wrong-key answer stops the run. When all three agree on the bench Artix-7 XC7A200T, you are done arguing.

Try it

Find the 11 recovery cases in the batch rehearsal and the three answers that stop the run; then say which of the three (spec, simulator, board) each one guards.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-batch-rehearsal · the batched wire protocol, rehearsed off-board
tri fpga-batch-rehearsal · the batched wire protocol, rehearsed off-board ↗

26 checks, no board, no RTL: a clean link returns every receipt with no retransmit, 11 loss and fault cases recover, and a lie, a duplicate or a wrong-key answer stops the run. self-test: PASS.

specs/tools/trios/tri/fpga-batch-cosim.t27

// SPDX-License-Identifier: Apache-2.0
@@ -105,6 +137,7 @@ 

Three-way agreement

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/three-way-jump/index.html b/apps/website/public/learn/three-way-jump/index.html index 9b1ed81f71..cc699c6b42 100644 --- a/apps/website/public/learn/three-way-jump/index.html +++ b/apps/website/public/learn/three-way-jump/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

A three-way jump

You will learn

Why one ternary compare can branch three ways.

A binary machine branches on a flag: to tell less, equal and greater apart it tests twice. A ternary compare answers with one trit, so one instruction can jump three ways. The widget compares a and b at their first differing trit, lit gold, and takes the matching target. The machine of the next lesson ends its loops with exactly this jump.

Try it

Make the jump take each of the three targets; then find two numbers that differ only in their lowest trit.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A three-way jump: one compare, three targets
A three-way jump: one compare, three targets ↗

Compare two registers once and jump on the trit: less, equal or greater. A binary machine needs two tests for the same branch.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

A three-way jump

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/times-a-trit/index.html b/apps/website/public/learn/times-a-trit/index.html index 327e80a2df..52d335615b 100644 --- a/apps/website/public/learn/times-a-trit/index.html +++ b/apps/website/public/learn/times-a-trit/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Times one trit

You will learn

Why multiplying by -1, 0 or +1 is a switch, not a multiplier.

A product by one trit has three cases: +1 copies the number, 0 drops it, -1 flips every trit. The spec's trit_times() is exactly that switch and contains no multiplication. This is why ternary neural networks are cheap in hardware: a weight of -1, 0 or +1 needs a multiplexer and an inverter, not a multiplier.

Try it

Multiply 25 by each trit and compare the tiles; then explain why a weight of 0 costs nothing in hardware.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Times one trit: copy, drop or flip
Times one trit: copy, drop or flip ↗

Multiplying by a trit needs no multiplier. By +1 the number is copied, by 0 dropped, by -1 every trit is flipped.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Times one trit

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/timing-slack/index.html b/apps/website/public/learn/timing-slack/index.html index a9665f2484..613efa27ce 100644 --- a/apps/website/public/learn/timing-slack/index.html +++ b/apps/website/public/learn/timing-slack/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Timing and slack

You will learn

What slack is, and how to read a timing report path by path.

Slack is how much time is left on a path when the clock period ends. Positive slack: the path is fast enough. Negative: the design fails at that clock. Each bar here is a real path from a routed design at 50 MHz, split into logic and routing, worst first. Find where the time goes on the worst path.

Try it

Click the worst path and compare its logic time with its routing time. In the spec frame, every clock_tree carries 100 ps of skew: find the test where a 50 ps budget fails, and the one where 200 ps passes.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Slack waterfall: every timing path of a routed design, worst first
Slack waterfall: every timing path of a routed design, worst first ↗

159 endpoints of a real nextpnr-xilinx run at 50 MHz as logic and routing waterfalls, checked bin by bin against nextpnr's log. Drop a --report JSON for yours.

specs/fpga/cts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -292,6 +324,7 @@ 

Timing and slack

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/tokens-that-burn/index.html b/apps/website/public/learn/tokens-that-burn/index.html index dca9add8ce..218678adfa 100644 --- a/apps/website/public/learn/tokens-that-burn/index.html +++ b/apps/website/public/learn/tokens-that-burn/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Tokens that burn

You will learn

When a batch of tokens burns, and which batch is spent first.

The owner's rule of 2026-10-01: all money goes into tokens, and tokens not spent within the month burn, so a person who paid makes content instead of saving tokens. Each batch lives MONTH_DAYS, 30 days, and days_left counts it down from the day it landed. On day 25 the package month from day 0 has 5 days left, the start gift from day 3 has 8, and a top-up from day 12 has 17. The spend order is soonest burn first.

Try it

Find the day the package month burns; then find the last day any batch is left.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Tokens that burn: a month to spend them
Tokens that burn: a month to spend them ↗

Three batches of tokens, each burning 30 days after it lands. Drag today across two months: days_left counts down every batch, and the one that burns soonest is spent first.

specs/automation/token-wallet.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Tokens that burn

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/tri-commands/index.html b/apps/website/public/learn/tri-commands/index.html index 87a2fe163a..cd6de82969 100644 --- a/apps/website/public/learn/tri-commands/index.html +++ b/apps/website/public/learn/tri-commands/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

tri: the command line

You will learn

What tri test does, how tri hands other words to t27c, and which commands are its own.

In the gHashTag/t27 repository, scripts/tri is a small wrapper. tri test runs the conformance suite, t27c suite --repo-root .; a word tri does not know, such as gen or seal, is passed on to t27c. Its own commands include audit, recall, frontier, lesson and help. This lesson read the script and did not run it: native t27c is built on a Linux machine, and this course does not run it on yours.

Try it

Read the table and say which commands go to t27c and which stay inside tri.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 24: where a tri command goes
t27 basics 24: where a tri command goes ↗

Which tri commands run inside the script and which are handed to t27c, read from scripts/tri in gHashTag/t27. Lesson 24 of the t27 basics course.

specs/basics/24_tri_commands.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

tri: the command line

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/trits/index.html b/apps/website/public/learn/trits/index.html index e3703fa964..5e039a7209 100644 --- a/apps/website/public/learn/trits/index.html +++ b/apps/website/public/learn/trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Trits: minus one, zero, one

You will learn

How a trit is written as a small signed constant and why 27 shows up everywhere.

A bit has two values; a trit has three: minus one, zero and one. The lesson spec writes them as i8 constants NEG, ZERO and POS, the way the tutorial specs of t27 do. Adding POS and NEG gives ZERO. Three trits have 3 times 3 times 3 combinations, which is 27: the number of lessons in this course and the cells of a TRI-27 word.

Try it

Write an assert that POS minus NEG equals 2, and check it passes.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 8: three values of a trit
t27 basics 8: three values of a trit ↗

The three values of a trit as t27 constants, and how three trits give 27 combinations. Lesson 8 of the t27 basics course.

specs/basics/08_trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -87,6 +119,7 @@ 

Trits: minus one, zero, one

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/true-false-and-text/index.html b/apps/website/public/learn/true-false-and-text/index.html index 9982645075..2d8540a217 100644 --- a/apps/website/public/learn/true-false-and-text/index.html +++ b/apps/website/public/learn/true-false-and-text/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

True, false and text

You will learn

How to declare a bool and a str, and what a test can compare them with.

A bool is true or false. A str is text in double quotes, and the text may hold characters that mean something elsewhere in t27, such as a semicolon or two slashes: inside quotes they are just text. A test compares a bool or a str with == and !=. One honest limit: the checker in this browser does not stop a str given to a u8 constant, so keep types and values matched yourself.

Try it

Change NAME in the lesson spec and fix the test so that it passes again.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 6: bool and str
t27 basics 6: bool and str ↗

The two non-number types of t27 in one table, with what a test can do with them. Lesson 6 of the t27 basics course.

specs/basics/06_true_false_and_text.t27

// SPDX-License-Identifier: Apache-2.0
@@ -84,6 +116,7 @@ 

True, false and text

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/twice-the-cost/index.html b/apps/website/public/learn/twice-the-cost/index.html index f6b834c42b..07f3046836 100644 --- a/apps/website/public/learn/twice-the-cost/index.html +++ b/apps/website/public/learn/twice-the-cost/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Twice the cost

You will learn

How the project prices an operation and what a month of tokens buys.

Every dollar becomes tokens at one rate, TOKEN_MICRO_USD 5000: a token is half a cent. price_tokens sells an operation at twice what it costs, MARKUP_PCT 200, and rounds up so nothing sells below that: a cost of 12300 micro-dollars is 5 tokens. month_tokens turns $20 into 4000 tokens, which is 14 reels of 270 tokens or 333 portraits of 12.

Try it

Find the costs that give exactly 1 token; then find the monthly price that buys 36 reels.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

The price of an operation: twice its cost, rounded up
The price of an operation: twice its cost, rounded up ↗

Drag what an operation costs the project and what a person pays a month: price_tokens sells it at twice the cost in half-cent tokens, and month_tokens turns dollars into tokens.

specs/automation/token-wallet.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Twice the cost

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/twiddles-and-bit-reversal/index.html b/apps/website/public/learn/twiddles-and-bit-reversal/index.html index e24416def0..8eb5ca536a 100644 --- a/apps/website/public/learn/twiddles-and-bit-reversal/index.html +++ b/apps/website/public/learn/twiddles-and-bit-reversal/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Twiddles and bit reversal

You will learn

Why a decimation-in-time FFT takes its input in bit-reversed order, and where the twiddles come from.

Split the input into even and odd samples, then split each half again, and the order you end up reading them in is the index with its bits reversed. At 8 points, index 1 is 001 and goes to place 4, and 3 is 011 and goes to place 6. Reversing twice gives the index back, so the reordering is a set of swaps that needs no arithmetic, only wiring. The twiddles W are points on the unit circle, cos minus j sin. The spec signals.t27 computes both.

Try it

At 16 points find every index that stays in its place; then pick an index and read its twiddle.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Bit reversal: the order an FFT reads its input in
Bit reversal: the order an FFT reads its input in ↗

Pick a size and an index: its bits read backwards give the place it takes at the input of a radix-2 FFT. See the whole crossing pattern at once.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Twiddles and bit reversal

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/two-bits-per-trit/index.html b/apps/website/public/learn/two-bits-per-trit/index.html index b3bb367231..85d6351e5b 100644 --- a/apps/website/public/learn/two-bits-per-trit/index.html +++ b/apps/website/public/learn/two-bits-per-trit/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Two bits per trit

You will learn

What it costs to store a trit in binary the simple way.

Binary memory stores a trit in two bits: -1 as 00, 0 as 01, +1 as 10, the packing this repository's hardware specs use. The code 11 means nothing. A trit carries log2(3) = 1.585 bits of information, so two bits are 79.25% used: a fifth of the memory carries nothing.

Try it

Pick each trit and read its code; say what a decoder should do with 11, and check what the spec's decode2() does.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

A trit in two bits, and the code nobody uses
A trit in two bits, and the code nobody uses ↗

Binary hardware stores a trit in two bits: -1 as 00, 0 as 01, +1 as 10. The fourth code, 11, means nothing: a quarter of the codes are wasted.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Two bits per trit

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/two-flop-sync/index.html b/apps/website/public/learn/two-flop-sync/index.html index f06bb36621..5691cb1763 100644 --- a/apps/website/public/learn/two-flop-sync/index.html +++ b/apps/website/public/learn/two-flop-sync/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The two-flop synchronizer

You will learn

Why two flops are the fix, and what the generated model of the crossing looks like.

The fix is two flops in the destination clock, nothing between them: the opening one may go metastable, and the second samples its settled output a full period later. Each extra stage multiplies MTBF by 2 to the power T_clk times log2 e over tau -- 295400 in Q10 at 100 MHz, the spec's stage_gain_q10(). The recording shows t27c gen on clock_domain.t27: the printed Zig is the crossing model the whole course leans on, and wc -l counts it. What the two flops cost is latency: two destination clocks from edge to settled output, the same price the release pipe of module 4 pays.

Try it

In the recording, find the wc -l count of the generated model; then in the spec frame find the two_flop strategy and say which module took it apart.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c gen on clock_domain.t27 -- the CDC model as Zig
t27c gen on clock_domain.t27 -- the CDC model as Zig ↗

t27c gen prints the clock-domain model it compiled, and wc -l says how many lines of Zig it is.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

The two-flop synchronizer

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/two-products-one-sum/index.html b/apps/website/public/learn/two-products-one-sum/index.html index e52506a340..3fe6173378 100644 --- a/apps/website/public/learn/two-products-one-sum/index.html +++ b/apps/website/public/learn/two-products-one-sum/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Two products, one sum

You will learn

How a GF-T16 multiply-accumulate computes a1 * b1 + a2 * b2, the kernel of a matrix multiply.

Every layer of a network is a stack of dot products, and a dot product is products added up. gft_dot2.t27 is the smallest one: y = a1 * b1 + a2 * b2 in GF-T16, a 16-bit magnitude of a 7-bit offset and a 9-bit mantissa with bias 40. In that layout 1.0 is code 20480 and 2.0 is code 20992. The spec has two tests: 1 * 1 = 1, and 1 * 1 + 1 * 1 = 2.

Try it

Find the two tests and decode 20480 and 20992 by hand with value = (1 + mant / 512) * 2^(offset - 40). Then find the line in gft_mul that handles the carry when the product passes 2.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 14: two products, one sum
GoldenFloat 14: two products, one sum ↗

The two tests of gft_dot2.t27, read from gft_dot2.t27. Lesson 14 of the GoldenFloat course.

specs/ternary/gft_dot2.t27

module GftDot2;
@@ -143,6 +175,7 @@ 

Two products, one sum

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/two-to-the-x/index.html b/apps/website/public/learn/two-to-the-x/index.html index 4d080ab618..00ae2c9122 100644 --- a/apps/website/public/learn/two-to-the-x/index.html +++ b/apps/website/public/learn/two-to-the-x/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Two to the x

You will learn

How exp2 splits x into a whole part and a fraction, and why its tests only reach the whole part.

The header of gft_exp2.t27 calls exp2 the missing building block for a GF-T softmax. on_comb splits x into a whole part k and a fraction f: k sets the offset, k + 40, and pow2_frac turns f into the mantissa. The header claims at most 1 ULP of error, measured in the prototype, but all 4 tests use whole inputs, 0, 1.0, -1.0 and 2.0, so f is 0 and pow2_frac returns 0 whatever its coefficients. The browser skips all 4 tests because its runner does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that drops the minus sign of k for negative x, and t27c test-report again: exactly one test fails, em1: 2^-1 comes out as 2.0, not 0.5. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the value em1 expects; then in the spec frame find pow2_frac and work out what it returns when f is 0.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_exp2.t27 -- two to the x, native
t27c on gft_exp2.t27 -- two to the x, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; dropping the minus sign of k makes exactly one test fail, em1; git restores the spec.

specs/ternary/gft_exp2.t27

module GftExp2;
@@ -135,6 +167,7 @@ 

Two to the x

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/use-other-modules/index.html b/apps/website/public/learn/use-other-modules/index.html index 2700b2794a..95aa6621dc 100644 --- a/apps/website/public/learn/use-other-modules/index.html +++ b/apps/website/public/learn/use-other-modules/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Using other modules

You will learn

How a use line is written, and what the browser can and cannot do with it.

use base::types; names a module by its path, with :: between the parts. The parser reads it as a use declaration. The compiler in your browser has no checkout of the other files, so it does not open base::types and does not check names that come from it. The native t27c resolves imports from a repository; this lesson could not run that check here.

Try it

Find the use declaration in the parser tree of the lesson spec in the player.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 19: what a use line does in the browser
t27 basics 19: what a use line does in the browser ↗

A t27 use line, how the parser reads it, and what the browser compiler leaves unchecked. Lesson 19 of the t27 basics course.

specs/basics/19_use_other_modules.t27

// SPDX-License-Identifier: Apache-2.0
@@ -81,6 +113,7 @@ 

Using other modules

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/vcd-format/index.html b/apps/website/public/learn/vcd-format/index.html index 8a41c48818..20c370be17 100644 --- a/apps/website/public/learn/vcd-format/index.html +++ b/apps/website/public/learn/vcd-format/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

The VCD format

You will learn

What a .vcd file actually contains, and how to read its dump of every signal.

A waveform file is text, and reading it as text is a skill. A .vcd declares its timescale, names its scopes and variables, then records only changes: a timestamp, an identifier, a value. The lesson's spec, vcd_trace, models exactly that -- headers, changes, durations -- with tests over earliest and latest change. The widget is a real trace wrapped up as a card: the testbench toggled clk 585 times and left 4 signals at X for the whole run, both facts counted from the file, not remembered from the screen.

Try it

Read the wrapped trace card: 585 toggles, 4 signals at X; then find in vcd_trace the function that counts changes at one timestamp.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

VCD wrapped: your simulation, summed up on one card
VCD wrapped: your simulation, summed up on one card ↗

Drop a .vcd from any simulator and get a Wrapped-style card: value changes, the busiest net, signals stuck at X or Z, the quietest ones and the time span, read in your browser.

specs/fpga/vcd_trace.t27

// SPDX-License-Identifier: Apache-2.0
@@ -360,6 +392,7 @@ 

The VCD format

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/verify-capstone/index.html b/apps/website/public/learn/verify-capstone/index.html index 11f2665c3a..ad8d141e60 100644 --- a/apps/website/public/learn/verify-capstone/index.html +++ b/apps/website/public/learn/verify-capstone/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Capstone: verify a module whole

You will learn

Carry one module from spec to board with the whole verification stack behind it.

One module, the whole stack. Take a design through the player (spec clean), the testbench (checks executed, not skipped), the vectors (answers beside inputs), cosimulation (spec, simulator, board agreeing on the bench Artix-7 XC7A200T), coverage (lines, toggles, arcs, illegal arcs cold), formal (assertions bounded, induction attempted, honestly), mutation (kill count on planted faults), and sign-off (one command, every receipt). The widget is the flow running for real: place, route, a loaded bitstream, the clock on screen. Nothing in this course is a step you outgrow.

Try it

Choose a module of your own and write its verification plan: vectors, tb checks, coverage targets, assertions, mutants, sign-off; then run the flow widget end to end and mark where your plan would have stopped a real bug.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Place and route to a loaded bitstream, timed
Place and route to a loaded bitstream, timed ↗

router1, bitwalk, xc7frames2bit, SRAM load: 19.06 s here, on a laptop at load average ~110.

specs/fpga/testbench/integration_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -200,6 +232,7 @@ 

Capstone: verify a module whole

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/verify-hardware/all/card.png b/apps/website/public/learn/verify-hardware/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..26ccf734c845a9d2cc6b16a80bcf5923a8fe2595 GIT binary patch literal 42944 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 + + + + + +Verifying hardware with t27: testbenches, waveforms, formal, mutation: the whole course on one page · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Course · Whole course on one page

+

Verifying hardware with t27: testbenches, waveforms, formal, mutation

+

For a reader who has a design and wants to trust it. Every lesson opens a real verification tool built from real runs on our bench: read a little, then break something on purpose.

+

27 lessons, one working widget and one t27 spec each: testbenches that check themselves, waveforms, vectors, cosimulation with the board, coverage, assertions, mutation, and a sign-off you can show.

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

+
Share the courseXTelegramLinkedIn
+ +

0 of 27 done

+

Open the interactive course →

+
+

Module 1 · Why verify

Designs that compile and are wrong, the model that decides, and the plan written before the code.

+
+
01

Lesson 1 of 27

Bugs that compile

+
+

You will learnWhy a clean compile proves so little, and what a seal without output is worth.

Everything here compiles. The UART testbench in the player is green on all seven backends, and it still proves almost nothing: a compile says the words parse and the types line up, not that the words are the ones you meant. The widget shows the bigger trap. Every merged spec in t27 carries a seal, a hash of what building it produced; 31 of 1,428 seals record no output at all, spread over 16 specs, and 3 of those are missing from the debt ledger that is supposed to name them. A seal with no output behind it is a green check with nothing under it -- verification begins exactly there.

Try it

Open the seal sweep and find the 16 specs with no output; then open uart_tb in the player and say out loud what a compile of it does not prove.

+
tri seals: hollow seals that pass every checkThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/uart_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+
02

Lesson 2 of 27

The golden model

+
+

You will learnWhat a reference model is, and how a conformance suite holds a tool to it.

To judge an implementation you need an answer that did not come from it: a golden model. For a number format that is the paper's table; for a tool it is the reference it claims to match. The widget is the conformance sweep that holds t27's own FPGA toolchain to its reference: 17 of 17 conformance specs compile, their test blocks pass, and no generated file has drifted from what was committed. The lesson's spec is the frame all those testbenches share -- the shapes a tb must have before it can check anything.

Try it

Open tri-fpga-specs and read one conformance spec's test blocks; then open testbench.t27 and name the four shapes a tb must have.

+
tri fpga-specs: every board spec, compiled and testedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench.t27 ↗
+
Open the interactive lesson →
+
+
+
+
03

Lesson 3 of 27

Plan before code

+
+

You will learnHow a verification plan is a checklist that a command can sweep and sign.

A test plan written after the code is a description of what the code does; written before, it is a claim the code must live up to. In this repo the plan is a spec, and a command sweeps it. The widget is that sweep for the bench tools: 14 of 14 pass their own self-tests in one run -- decode 18/18, repin 17/17 -- and any tool that cannot check itself is listed, not waved through. The lesson's spec is build_verify: the checklist of what a build must show before anyone calls it done.

Try it

Run the tool sweep and find the one tool whose self-test is listed rather than run; then read build_verify's checklist and mark which items are counts and which are claims.

+
tri fpga-tools · 14 bench tools test themselvesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/verification/build_verify.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 2 · Testbenches

Stimulus, checks and a verdict, written as one spec beside the design it judges.

+
+
04

Lesson 4 of 27

Anatomy of a testbench

+
+

You will learnThe parts every *_tb.t27 spec has: stimulus, expected values, checks, a verdict.

Every testbench in this repo is one .t27 file with the same skeleton, and the player compiles it like any other spec. Open fifo_tb: it builds the stimulus (bytes into a FIFO), the expected values (the same bytes, in order), the checks (one assert per invariant, so a failure names the one that broke), and a verdict (a count, not a feeling). The widget generates JavaScript from a spec in the browser and runs it -- the same generate-then-execute shape a testbench uses, small enough to watch happen.

Try it

Generate JavaScript for the fifo_tb spec in the player and run it; find the assert that would fail first if the FIFO dropped a byte.

+
hello_world.t27 to JavaScript, in a terminal inside the postThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/fifo_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+
05

Lesson 5 of 27

Self-checking, not staring

+
+

You will learnHow to write a testbench that fails loudly, and why eyeballing waves is not a check.

A testbench that prints waves and stops is a machine for producing staring. A self-checking one computes a verdict and exits nonzero when it fails, so a script can run a thousand of them and trust the exit code. The widget is the terminal for seven t27 backends: every command run on hello_world, 21 pass, 0 fail -- every pass earned by an assert that executed, not by finishing. The lesson's spec, spi_tb, ends the same way: a count of checks, and a failure mode that cannot be mistaken for success.

Try it

Open the seven-backend terminal and find one command whose pass ran zero asserts; then check spi_tb for a failure mode that cannot print 'ok'.

+
t27 play · the terminal's own gatesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/spi_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+
06

Lesson 6 of 27

Directed versus random

+
+

You will learnWhen one carefully chosen case beats a thousand random ones, and when it does not.

A directed test is one case you chose because you know it bites: the empty FIFO, the full one, the wrap. A random one is cheap volume. They are not rivals; they are a sequence. The widget is the knockout experiment turned into a tool: three performance bits were claimed, and one knockout bitstream per bit -- the same design with that bit tied off -- proves each one matters. That is directed testing's whole argument: one bit, one prediction, one bitstream, measured.

Try it

Pick one performance bit in the knockout widget and say what the no-knockout run would have to show for the bit to be a lie.

+
Three PERF2 bits, and one knockout bitstream per bitThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/uart_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 3 · Waveforms

A trace of every signal, read the way a hardware engineer reads it, and two runs compared.

+
+
07

Lesson 7 of 27

The VCD format

+
+

You will learnWhat a .vcd file actually contains, and how to read its dump of every signal.

A waveform file is text, and reading it as text is a skill. A .vcd declares its timescale, names its scopes and variables, then records only changes: a timestamp, an identifier, a value. The lesson's spec, vcd_trace, models exactly that -- headers, changes, durations -- with tests over earliest and latest change. The widget is a real trace wrapped up as a card: the testbench toggled clk 585 times and left 4 signals at X for the whole run, both facts counted from the file, not remembered from the screen.

Try it

Read the wrapped trace card: 585 toggles, 4 signals at X; then find in vcd_trace the function that counts changes at one timestamp.

+
VCD wrapped: your simulation, summed up on one cardThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/vcd_trace.t27 ↗
+
Open the interactive lesson →
+
+
+
+
08

Lesson 8 of 27

Debug with waves

+
+

You will learnHow to go from a symptom to a signal, cycle by cycle, on a real measured bug.

Here is a bug found with waves, end to end. A UART link on the bench requested 115,200 baud and the wire carried 115,385 -- a +0.16 % error from the clock divider, invisible in code, obvious in a capture. Requested 921,600, the wire carries 923,077, the same fractional error; 3,000,000 divides exactly and is exact on the wire. The measurement names the fix: choose divisors that land on integers. Waves turn a symptom (bytes lost) into a number (0.16 %) into an edit.

Try it

Compute what divider would put 115,200 on the wire exactly; check it against the 921,600 and 3,000,000 rows in the widget.

+
tri fpga-wire · the baud rate actually on the wireThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/vcd_trace_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+
09

Lesson 9 of 27

Compare two traces

+
+

You will learnHow to diff two runs and have the trace name the earliest cycle where they split.

Two runs of the same testbench, one before a change and one after: the fastest question is where they split. A trace diff answers at the resolution of one signal change: the earliest cycle where the golden run says 1 and the new run says 0. The widget diffs files this way, frame by frame, and refuses to say 'same' when a byte differs. The lesson's spec is the testbench that drives the VCD comparison tool -- expected against actual, with the mismatch printed, not eyeballed.

Try it

Open the diff widget on two files of your own; then find in the compare testbench where the earliest mismatching cycle would be printed.

+
Bitstream diff: two 7-series .bit files, frame by frameThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/vcd_conformance_compare_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 4 · Conformance vectors

Cases with the answer written beside them, kept where the compiler can reach them.

+
+
10

Lesson 10 of 27

What a vector is

+
+

You will learnWhat a test vector is, and why the answer belongs beside the input, in the file.

A vector is an input with the correct output written next to it, in a file a tool can read. That last clause is where vectors usually die: 34 vector files with 512 cases live in the corpus, and the sweep behind the widget counted 2 files actually executed, 8 recorded as debt, 24 prose-only -- descriptions of cases no runner can parse. 19% carry data. A vector that nothing executes is documentation wearing a testbench's clothes.

Try it

Count the vector files in the widget's census that no runner executes; then write one vector, with its answer, in a file a tool could parse.

+
tri vectors debt: tests that are proseThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/formats_catalog.t27 ↗
+
Open the interactive lesson →
+
+
+
+
11

Lesson 11 of 27

Golden ruler vectors

+
+

You will learnHow a catalog works as a ruler: every population recounted, every count agreeing.

A ruler only works if it does not stretch. The formats catalog is t27's ruler for number formats, and the widget is the check on the ruler itself: four census populations -- counted in the catalog, recounted another way -- all agree, and the three that cannot be checked are named as uncheckable rather than rounded into agreement. That is the pattern to copy: recount every count a second way, and publish the ones you cannot.

Try it

Open the census widget and name the three populations marked uncheckable; then read the formats catalog and find one count stated twice.

+
tri census audit: every census, counted twiceThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/numeric/formats_catalog.t27 ↗
+
Open the interactive lesson →
+
+
+
+
12

Lesson 12 of 27

End-to-end scenarios

+
+

You will learnHow a scenario walks a whole flow, and what an end-to-end run proves that units cannot.

Unit tests prove the pieces; a scenario proves the pipe. The lesson's spec, e2e_demo, walks one design from spec to board in a single run, so a failure anywhere in the chain fails one place with a name. The widget draws the whole FPGA flow one layer per line -- spec, Verilog, cells, placement, bitstream, board -- and an end-to-end scenario is exactly that picture as a test: every layer either produces its artefact or stops the run.

Try it

Walk the flow widget layer by layer and say what artefact each layer must produce; then find in e2e_demo where a missing artefact stops the run.

+
tri devkit · the FPGA flow, layer by layerThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/e2e_demo.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 5 · Cosimulation

Spec, simulator and board agreeing on the bench Artix-7 XC7A200T, and what to do when they do not.

+
+
13

Lesson 13 of 27

Three-way agreement

+
+

You will learnHow spec, simulator and board are held to one answer, and what each one is trusted for.

Three answers, one question. The spec says what should happen; the simulator says what a model of the silicon does; the board says what the silicon does. The widget is the rehearsal for that agreement with the board taken out of the loop: 26 checks, no board, no RTL -- a clean link returns every receipt with no retransmit, 11 loss and fault cases recover, and a lie, a duplicate or a wrong-key answer stops the run. When all three agree on the bench Artix-7 XC7A200T, you are done arguing.

Try it

Find the 11 recovery cases in the batch rehearsal and the three answers that stop the run; then say which of the three (spec, simulator, board) each one guards.

+
tri fpga-batch-rehearsal · the batched wire protocol, rehearsed off-boardThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/fpga-batch-cosim.t27 ↗
+
Open the interactive lesson →
+
+
+
+
14

Lesson 14 of 27

Inside the simulator

+
+

You will learnWhat a simulator keeps (state) and what it does not (time between events).

A simulator is state plus a queue of things that happen, and knowing that is what makes its output trustworthy. The lesson's spec, simulator, models the engine itself: states, probe points, trace entries, and the loop that drains events in order. The widget reads the real bench the way a simulator holds state: cables, boards, locks, and the last board runs -- three x7-board runs PASS 51840/51840 -- one command, one snapshot, no narratives between.

Try it

In simulator.t27 find the loop that drains events and say what it would do if two events shared a timestamp; then compare with the status widget's one-snapshot read.

+
tri fpga-status · the bench at a glanceThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/simulator.t27 ↗
+
Open the interactive lesson →
+
+
+
+
15

Lesson 15 of 27

When they disagree

+
+

You will learnHow to triage a disagreement: which of the three is lying, and how to find out.

When spec, simulator and board disagree, one of them is lying and the disagreement itself tells you where to look. If the simulator matches the spec but the board differs, suspect constraints, timing, or the model's assumptions -- pin assignments first, they are the usual liar. The widget is the triage tool for exactly that class: before an edit to a Verilog file, every spec and generator it would touch, so a fix cannot silently wander. Breadth first (what changes?), then depth (why does this one?).

Try it

Make the triage list: for each mismatch direction (spec vs simulator, simulator vs board), name the file you would open before any other, and why.

+
tri fpga-pins · the blast radius of an edit, before the editThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/fpga-batch-cosim.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 6 · Coverage

What the tests touched: lines, toggles, states, and what that number hides.

+
+
16

Lesson 16 of 27

Line and toggle

+
+

You will learnHow line and toggle coverage count what a run touched, signal bit by signal bit.

Line coverage asks: did anything execute this line? Toggle coverage asks a sharper question per bit: did this signal ever go 0-to-1, and ever 1-to-0? A stuck signal can sit under 100 % line coverage forever. The lesson's spec is coverage.t27 -- points with hit counts, per-kind percentages, and illegal arcs that must stay at zero -- with 26 tests and 4 invariants of its own. The widget bars a real design's resources; coverage bars are the same picture drawn over what a run touched.

Try it

Count the points in coverage.t27's fsm_report test and check the percentage by hand; then find one signal in the resource widget a toggle count would flag.

+
Resource bars: LUT, FF, BRAM and DSP used on the XC7A200TThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/coverage.t27 ↗
+
Open the interactive lesson →
+
+
+
+
17

Lesson 17 of 27

FSM coverage

+
+

You will learnHow state and transition coverage see the arcs a run never took.

A state machine is verified by its arcs, not its states: 4 states with 12 transitions is 12 ways to be wrong, and visiting every state can leave half the arcs cold. The spec models it directly: state points and transition points, each with a hit count, and illegal transitions that fail the report the moment one warms. The widget is the discipline in another shape: 112 files pinned by sha256 in specs, every one accounted for -- 0 lost, 0 not kept, 0 unlocated. Nothing on the list is allowed to be unvisited.

Try it

List the arcs of a 4-state FIFO FSM and mark which a read-only workload leaves cold; then find the illegal arcs in the spec and what warms them.

+
tri fpga-tmpcheck · every /tmp file a spec pins, keptThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/coverage.t27 ↗
+
Open the interactive lesson →
+
+
+
+
18

Lesson 18 of 27

Coverage lies

+
+

You will learnWhy a coverage number can be a check that checked nothing, and how to spot it.

A coverage percentage is a claim about the tests, and claims can be empty. The widget found the empty kind: 11 specs refused at parse, 0 blocked only by prose, and 23 broken on purpose as fixtures -- but elsewhere in the corpus a 'test' that is only prose passes every check while executing nothing. The tells are always the same: a number with no denominator, a pass with no assert that ran, a sweep that cannot fail. Ask of every percentage: what would make this number move?

Try it

In the prose sweep, find the difference between 'refused at parse' and 'blocked only by prose'; then write a test whose pass executes no assert.

+
tri prose report: prose, or code?The widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/fifo_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 7 · Formal

Assertions that hold every cycle, bounded search for a counterexample, and why a proof needs induction.

+
+
19

Lesson 19 of 27

Assertions

+
+

You will learnWhat an assertion is in code, and what it costs to check one every cycle.

An assertion is a check that stays in the design, every cycle, forever: not a testbench that runs once, but a sentence about the hardware that must hold while the hardware runs. The lesson's spec, formal, writes them as data -- immediate and concurrent, severities, clock and reset named -- because an assertion you cannot enumerate is an assertion you cannot discharge. The widget is the same idea at the door: each dependency the tool needs, present or not, checked in one call before anything runs.

Try it

Write one immediate and one concurrent assertion for a FIFO, with clock and reset named; then check the dependency widget for what tri itself assumes.

+
tri selftest: the dependencies tri needsThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/formal.t27 ↗
+
Open the interactive lesson →
+
+
+
+
20

Lesson 20 of 27

Bounded model checking

+
+

You will learnHow a bounded search explores every input up to k cycles, and what that proves.

Bounded model checking is exhaustive search with a horizon: every input, every state, up to k cycles -- does any of them break the assertion? Inside the bound it is a proof, not a sample; no random seed can miss what the search enumerates. The lesson's spec carries the shape: a depth, a timeout, and properties to check. The widget is a bounded search in another domain: 84 board and model logs scanned for a key that must appear in none -- 0 hits, 0 logs too big to read -- absence, checked exhaustively rather than assumed.

Try it

Set a depth k and say exactly what your BMC run proves and does not; then find in the key sweep what '0 hits' took to be checkable rather than assumed.

+
tri fpga-keycheck: the key is counted, never printedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/formal.t27 ↗
+
Open the interactive lesson →
+
+
+
+
21

Lesson 21 of 27

Induction

+
+

You will learnWhy bounded is not a proof, and how induction closes the gap -- or reports it cannot.

Bounded means bounded: k cycles checked is all k proves. To close the gap you need induction -- assume the invariant held up to cycle k, show it holds at k+1 -- and induction is honest in a way BMC is not: it can fail, and a failed induction is a finding, not an embarrassment. The widget is what an un-discharged obligation looks like when nobody looks: 12 Lean files, 15,553 lines and 4 sorry, reached by no build root -- nothing compiles them, so the proofs they contain have never been checked. An obligation no root reaches is not discharged; it is parked.

Try it

Find the 4 sorry in the Lean sweep and say what a build root that reached them would change; then name one invariant of uart_tb you would try to induct.

+
tri lean: proofs that nothing compilesThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/formal_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 8 · Mutation

Break the design on purpose and count what the tests catch.

+
+
22

Lesson 22 of 27

Kill the mutant

+
+

You will learnHow mutation testing plants a bug on purpose and asks the tests to notice.

Mutation testing inverts the whole game: instead of asking whether the tests pass, break the design on purpose and ask whether the tests notice. The widget is the tool doing it to a bitstream path -- plant a bug, watch the tests catch it -- and the lesson's spec is the command that owns the planting. A test suite that passes everything and catches no mutant is a suite that cannot fail, and a suite that cannot fail is not protecting anything.

Try it

Plant a bug with the mutate tool and watch which test catches it; then read the spec and find where the planted fault is named.

+
tri x7-mutate · plant a bug, the tests must catch itThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/x7-mutate.t27 ↗
+
Open the interactive lesson →
+
+
+
+
23

Lesson 23 of 27

Surviving mutants

+
+

You will learnWhat a surviving mutant tells you about the test that let it live.

A surviving mutant is the most specific bug report you will ever get: here is a fault, here is the test that should have caught it, here is why it did not. The widget counted them where nobody was looking: 367 PRs landed on t27 in 14 days, and 11 of them deleted tests or asserts; one PR, titled to sound like an implementation, deleted all 26 tests in its file and nothing failed. Every one of those 11 was a mutant that survived -- and it survived because a human let it, which is exactly the failure mode mutation testing exists to catch.

Try it

Open the test-touch widget and find the PR that deleted all 26 tests; then say what check would have caught it at review time.

+
Did the agent touch its own tests? Every PR merged on t27, checkedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/x7-mutate.t27 ↗
+
Open the interactive lesson →
+
+
+
+
24

Lesson 24 of 27

Test strength

+
+

You will learnHow to measure a suite, not admire it: caught mutants, deleted tests, vacuous passes.

Coverage says what you ran; mutation says what your running is worth. A suite's strength is its kill count on faults you chose, its behavior when tests are deleted, its share of passes that executed an assert. The widget is the reference side of that measuring: all 6 reference bitstreams present and read -- 84.4 ms, best of 5 -- so a speed or strength number always stands on a reference somebody pinned. Measure the suite, or admit you are admiring it.

Try it

Measure one thing twice, two ways, in the refs widget's style; then say which of your own suite's numbers has no denominator.

+
tri x7-part · x7-refs · x7-bench: the references the bitstream path is checked onThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/x7-mutate.t27 ↗
+
Open the interactive lesson →
+
+
+
+

Module 9 · Sign-off

One command, every receipt, a clean verdict you can show.

+
+
25

Lesson 25 of 27

Build and verify

+
+

You will learnHow one command re-runs every sweep and turns a build into a verdict.

A build is not a verdict until one command can re-derive it. The widget is that command for the bitstream stack: CRC 12/12 over the references, ECC 32520/32520 frames, 82/82 pins, 4224/4224 segbits, gold 5/5 -- every sweep re-run, every count with its denominator, and the last line says audit: CLEAN. The lesson's spec, build_verify, is the same list as a spec. If a person has to remember to run the checks, the checks will someday not be run.

Try it

Run the audit and find the one count with the largest denominator; then read build_verify and mark which checks are re-derived, not remembered.

+
tri x7-audit · the whole bitstream path, re-checkedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/verification/build_verify.t27 ↗
+
Open the interactive lesson →
+
+
+
+
26

Lesson 26 of 27

The board self-tests

+
+

You will learnHow the bench checks itself: every script running its own self-test, nothing skipped.

The bench checks itself before it checks your design: 16 spec-named scripts run their own --self-test, 0 bad, and the 8 scripts that have no such flag are listed, not silently skipped -- the difference between 'all good' and 'all we measured'. The widget is that sweep. The lesson's spec is fpga-selftest, the inventory of what a self-test is. A bench that cannot say which of its tools are untested is a bench whose verdicts carry unknown error bars.

Try it

Open the self-test sweep and find the 8 scripts without a flag; then say what listing them, instead of skipping them, buys you.

+
tri fpga-selftest: off-board self-tests, no port openedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/tools/trios/tri/fpga-selftest.t27 ↗
+
Open the interactive lesson →
+
+
+
+
27

Lesson 27 of 27

Capstone: verify a module whole

+
+

You will learnCarry one module from spec to board with the whole verification stack behind it.

One module, the whole stack. Take a design through the player (spec clean), the testbench (checks executed, not skipped), the vectors (answers beside inputs), cosimulation (spec, simulator, board agreeing on the bench Artix-7 XC7A200T), coverage (lines, toggles, arcs, illegal arcs cold), formal (assertions bounded, induction attempted, honestly), mutation (kill count on planted faults), and sign-off (one command, every receipt). The widget is the flow running for real: place, route, a loaded bitstream, the clock on screen. Nothing in this course is a step you outgrow.

Try it

Choose a module of your own and write its verification plan: vectors, tb checks, coverage targets, assertions, mutants, sign-off; then run the flow widget end to end and mark where your plan would have stopped a real bug.

+
Place and route to a loaded bitstream, timedThe widget loads as you scroll to it.
Open the widget on its own page ↗Open the lesson's spec in the player: specs/fpga/testbench/integration_tb.t27 ↗
+
Open the interactive lesson →
+
+
+
+ +
+
+ +
Contents
  1. 01 · Why verify
    1. 01 Bugs that compile
    2. 02 The golden model
    3. 03 Plan before code
  2. 02 · Testbenches
    1. 04 Anatomy of a testbench
    2. 05 Self-checking, not staring
    3. 06 Directed versus random
  3. 03 · Waveforms
    1. 07 The VCD format
    2. 08 Debug with waves
    3. 09 Compare two traces
  4. 04 · Conformance vectors
    1. 10 What a vector is
    2. 11 Golden ruler vectors
    3. 12 End-to-end scenarios
  5. 05 · Cosimulation
    1. 13 Three-way agreement
    2. 14 Inside the simulator
    3. 15 When they disagree
  6. 06 · Coverage
    1. 16 Line and toggle
    2. 17 FSM coverage
    3. 18 Coverage lies
  7. 07 · Formal
    1. 19 Assertions
    2. 20 Bounded model checking
    3. 21 Induction
  8. 08 · Mutation
    1. 22 Kill the mutant
    2. 23 Surviving mutants
    3. 24 Test strength
  9. 09 · Sign-off
    1. 25 Build and verify
    2. 26 The board self-tests
    3. 27 Capstone: verify a module whole
+ + + + + diff --git a/apps/website/public/learn/verify-hardware/index.html b/apps/website/public/learn/verify-hardware/index.html index ac7bcc20f9..d9e9cf6350 100644 --- a/apps/website/public/learn/verify-hardware/index.html +++ b/apps/website/public/learn/verify-hardware/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский

Course

Verifying hardware with t27: testbenches, waveforms, formal, mutation

For a reader who has a design and wants to trust it. Every lesson opens a real verification tool built from real runs on our bench: read a little, then break something on purpose.

27 lessons, one working widget and one t27 spec each: testbenches that check themselves, waveforms, vectors, cosimulation with the board, coverage, assertions, mutation, and a sign-off you can show.

-

Open the interactive course →

+

Open the interactive course → Whole course on one page →

+

Every course is free, for everyone: no sign-up, no email, nothing to pay.

All lessons

+
diff --git a/apps/website/public/learn/what-a-spec-is/index.html b/apps/website/public/learn/what-a-spec-is/index.html index ee255deb5a..ddd86b9e27 100644 --- a/apps/website/public/learn/what-a-spec-is/index.html +++ b/apps/website/public/learn/what-a-spec-is/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

What a spec is

You will learn

What goes into a .t27 file and what the compiler gives back for it.

A spec is a plain text file that ends in .t27. It opens with a module line, declares values and functions, and carries test blocks that check them. The compiler, t27c, reads the file and answers with a verdict and code for 7 backends. The spec under this lesson has 2 constants and 1 test, and the site compiles it in your browser.

Try it

Open the lesson spec in the player and find its three parts: the module line, the constants, the test.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 1: the three parts of a spec
t27 basics 1: the three parts of a spec ↗

A table of the parts of a .t27 file and a diagram of what t27c gives back for it. Lesson 1 of the t27 basics course.

specs/basics/01_what_a_spec_is.t27

// SPDX-License-Identifier: Apache-2.0
@@ -81,6 +113,7 @@ 

What a spec is

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/what-a-vector-is/index.html b/apps/website/public/learn/what-a-vector-is/index.html index 0b02b28aa0..6be9e82719 100644 --- a/apps/website/public/learn/what-a-vector-is/index.html +++ b/apps/website/public/learn/what-a-vector-is/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

What a vector is

You will learn

What a test vector is, and why the answer belongs beside the input, in the file.

A vector is an input with the correct output written next to it, in a file a tool can read. That last clause is where vectors usually die: 34 vector files with 512 cases live in the corpus, and the sweep behind the widget counted 2 files actually executed, 8 recorded as debt, 24 prose-only -- descriptions of cases no runner can parse. 19% carry data. A vector that nothing executes is documentation wearing a testbench's clothes.

Try it

Count the vector files in the widget's census that no runner executes; then write one vector, with its answer, in a file a tool could parse.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri vectors debt: tests that are prose
tri vectors debt: tests that are prose ↗

34 vector files, 512 cases: 2 files executed, 8 debt, 24 prose-only; 19% carry data.

specs/numeric/formats_catalog.t27

// SPDX-License-Identifier: Apache-2.0
@@ -563,6 +595,7 @@ 

What a vector is

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/what-arithmetic-costs/index.html b/apps/website/public/learn/what-arithmetic-costs/index.html index ee0ae3d440..5a1564e720 100644 --- a/apps/website/public/learn/what-arithmetic-costs/index.html +++ b/apps/website/public/learn/what-arithmetic-costs/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

What arithmetic costs

You will learn

Why a multiplier is expensive and an adder is cheap, measured on a real chip.

In logic, every operation has a price paid in chip resources. An adder is a carry chain, cheap and fast. A multiplier built from LUTs is large; the chip has DSP blocks made for multiplying, and a synthesizer uses them when it may. These curves are real yosys counts from 4 to 64 bits. Switch DSPs off and on, and see why hardware people care so much about the width of every number.

Try it

Pick Multiply, switch DSP48E1 to -nodsp, and compare the LUTs at 32 bits with and without DSPs.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Cost curves: adders, multipliers and MACs on a Xilinx 7-series
Cost curves: adders, multipliers and MACs on a Xilinx 7-series ↗

Real yosys synth_xilinx counts for add, multiply, MAC and compare from 4 to 64 bits, with and without DSPs, against a whole XC7A200T, and t27 ternary specs beside them.

specs/tutorial/05_widths_and_casts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -183,6 +215,7 @@ 

What arithmetic costs

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/when-they-disagree/index.html b/apps/website/public/learn/when-they-disagree/index.html index c8d5f42f45..5303ee560d 100644 --- a/apps/website/public/learn/when-they-disagree/index.html +++ b/apps/website/public/learn/when-they-disagree/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

When they disagree

You will learn

How to triage a disagreement: which of the three is lying, and how to find out.

When spec, simulator and board disagree, one of them is lying and the disagreement itself tells you where to look. If the simulator matches the spec but the board differs, suspect constraints, timing, or the model's assumptions -- pin assignments first, they are the usual liar. The widget is the triage tool for exactly that class: before an edit to a Verilog file, every spec and generator it would touch, so a fix cannot silently wander. Breadth first (what changes?), then depth (why does this one?).

Try it

Make the triage list: for each mismatch direction (spec vs simulator, simulator vs board), name the file you would open before any other, and why.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-pins · the blast radius of an edit, before the edit
tri fpga-pins · the blast radius of an edit, before the edit ↗

Before editing trinet_node_core.v: 5 specs pin it by sha256 and 5 generators read those specs. radius: 5 specs, 1 level, the exact set fpga-repin walks after the edit.

specs/tools/trios/tri/fpga-batch-cosim.t27

// SPDX-License-Identifier: Apache-2.0
@@ -105,6 +137,7 @@ 

When they disagree

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/where-next/index.html b/apps/website/public/learn/where-next/index.html index 670a27cf03..305c1c133f 100644 --- a/apps/website/public/learn/where-next/index.html +++ b/apps/website/public/learn/where-next/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Where to go next

You will learn

Which course to take next, and what each one adds to the basics.

You can now read a spec: its module line, constants, types, functions, tests and the code its backends write. Course 1 follows a spec onto an Artix-7 FPGA: synthesis, placement, timing and a bitstream checked on a board. Course 2 builds number formats for AI in t27, from OCP MX blocks to a ternary network. Both courses have 27 lessons and open a spec in every one.

Try it

Pick the next course from the table and open its lesson 1.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 27: three courses, in order
t27 basics 27: three courses, in order ↗

The three t27 courses in order, what each one covers and where it starts. Lesson 27 of the t27 basics course.

specs/basics/27_where_next.t27

// SPDX-License-Identifier: Apache-2.0
@@ -82,6 +114,7 @@ 

Where to go next

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/where-the-clock-enters/index.html b/apps/website/public/learn/where-the-clock-enters/index.html index fb18281224..f6cc0874fe 100644 --- a/apps/website/public/learn/where-the-clock-enters/index.html +++ b/apps/website/public/learn/where-the-clock-enters/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Where the clock enters

You will learn

Where a board's clock really comes from, and how a ring oscillator inside the chip was measured on three dice over JTAG.

The clock enters the board, not the chip: an oscillator on the PCB drives a pin. The board spec of the QMTech Wukong (XC7A200T in an FGG676 package, part xc7a200tfgg676) also measures a clock that never leaves the chip: CFGMCLK, a ring oscillator with no crystal behind it. UG470 gives 65 MHz nominal over a 50-80 MHz envelope. It was measured on the three attached dice by timing a 2^24 prescaler over JTAG: 70770, 68490 and 67200 kHz. The recording runs the native t27c on the board spec: 15 tests pass, 11 invariants are proved comptime.

Try it

In the recording, find the three measured CFGMCLK values and the busdev numbers of their dice; then in the spec frame find the UG470 envelope they are compared with and the prescaler that made them readable.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on wukong_v1.t27 -- the board spec, native
t27c on wukong_v1.t27 -- the board spec, native ↗

t27c 0.4.0 on a laptop (macOS): 15 tests of the Wukong board spec pass natively and 11 invariants are proved comptime; the part line names the xc7a200tfgg676 the board carries.

specs/boards/wukong_v1.t27

// SPDX-License-Identifier: Apache-2.0
@@ -365,6 +397,7 @@ 

Where the clock enters

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/where-the-luts-go/index.html b/apps/website/public/learn/where-the-luts-go/index.html index accdaba014..3080bc78cf 100644 --- a/apps/website/public/learn/where-the-luts-go/index.html +++ b/apps/website/public/learn/where-the-luts-go/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Where the LUTs go

You will learn

Which part of a design spends the LUTs, and why hierarchy matters.

A design is built from modules that contain modules. When yosys keeps the hierarchy, it counts each submodule once, and the instance counts tell you how many copies there are. The treemap multiplies them out and shows which submodule eats the LUTs. One adder used many times can cost more than everything else together.

Try it

Switch between the hierarchical and flattened totals and find the largest tile. In the spec frame, find fpga_util and the test that turns 31700 used LUTs into a share of one chip: what percent does it get?

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

LUT treemap: which submodule eats your LUTs, from yosys stat -json
LUT treemap: which submodule eats your LUTs, from yosys stat -json ↗

Drop yosys stat -json from a run without -flatten: a treemap of LUTs or FFs per submodule, each times its instance count, beside the flattened total. Read in your browser.

specs/fpga/partition.t27

// SPDX-License-Identifier: Apache-2.0
@@ -328,6 +360,7 @@ 

Where the LUTs go

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/which-chip/index.html b/apps/website/public/learn/which-chip/index.html index 16bc4c7bb3..63874b090d 100644 --- a/apps/website/public/learn/which-chip/index.html +++ b/apps/website/public/learn/which-chip/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Which chip is this?

You will learn

How a chip names itself in 32 bits, and how to read those bits.

Before you load anything, you ask the board which chip it has. Over JTAG every chip answers with a 32-bit IDCODE: a version, a part number, the manufacturer and a fixed 1 in bit 0. A bitstream built for the wrong part is refused by the chip, so this is the check that saves you an afternoon. The decoder splits the bits into those four fields and looks the part up in openFPGALoader's own table.

Try it

Click the bench preset, then flip one bit of the part number and see which device it would be. In the spec frame, the idcode-cfg action names the IDCODE a healthy XC7A100T returns: decode it and compare its part number with the bench chip's.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

JTAG IDCODE decoder: 32 bits, four fields, one device
JTAG IDCODE decoder: 32 bits, four fields, one device ↗

Paste a 32-bit JTAG IDCODE: version, part number, JEDEC manufacturer and the fixed 1 in bit 0 as clickable bits, then the device from openFPGALoader's own table.

specs/tools/tri/fpga.t27

// SPDX-License-Identifier: Apache-2.0
@@ -111,6 +143,7 @@ 

Which chip is this?

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/who-holds-the-io/index.html b/apps/website/public/learn/who-holds-the-io/index.html index 18d7eae880..10fac2e08e 100644 --- a/apps/website/public/learn/who-holds-the-io/index.html +++ b/apps/website/public/learn/who-holds-the-io/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Who holds the IO

You will learn

Who holds the bench IO right now, and what the registered clients declare.

Real hardware shared is hardware borrowed: the bench registers its IO clients, and the recording reads them live -- names, claims and what each declares it owns. The spec is the tool card of tri fpga-ioclients. The lesson closes the loop the course opened: a bus, its spec, its bench, and now the hands on it.

Try it

In the recording, list the clients the bench reports; then in the spec frame find what a client must declare to register.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

tri fpga-ioclients -- who holds the bench IO
tri fpga-ioclients -- who holds the bench IO ↗

The registered IO clients on the bench, read live: names, claims and what each client declares it owns.

specs/tools/trios/tri/fpga-ioclients.t27

// SPDX-License-Identifier: Apache-2.0
@@ -107,6 +139,7 @@ 

Who holds the IO

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/who-is-called/index.html b/apps/website/public/learn/who-is-called/index.html index dfa530c1ed..7f7219e4cf 100644 --- a/apps/website/public/learn/who-is-called/index.html +++ b/apps/website/public/learn/who-is-called/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Who is called

You will learn

Which messages in the hive group wake an agent, from a person and from another agent's bot.

Every agent has its own bot and its own topic in one forum group. A person calls an agent by its tag, by @all, by a reply, or by writing in its topic. Another agent's bot calls it only by a tag or a reply: a bot never triggers the whole hive and never wakes a topic's owner by merely writing there. addressed in agent-hive-group.t27 is that rule, one line long.

Try it

Find the two ways only a person can call an agent; then turn on all four and compare the senders.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Who is called: an agent bot in a group of agents
Who is called: an agent bot in a group of agents ↗

Each agent has its own bot and topic in one group. Toggle how a message reaches an agent: addressed answers for a person and for another agent's bot.

specs/automation/agent-hive-group.t27

// SPDX-License-Identifier: Apache-2.0
@@ -429,6 +461,7 @@ 

Who is called

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/whole-numbers/index.html b/apps/website/public/learn/whole-numbers/index.html index 72499a70b7..2dfa5312c0 100644 --- a/apps/website/public/learn/whole-numbers/index.html +++ b/apps/website/public/learn/whole-numbers/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Whole numbers and their widths

You will learn

The integer types, their ranges, and the error a value too big for its type gets.

A u in the type name means unsigned, an i means signed, and the digits are the number of bits. u8 holds 0 to 255, u16 holds 0 to 65535, i32 holds negative numbers too. The compiler checks a constant against its type: give a u8 the value 300 and it stops with an error that says no u8 can hold 3 digits. The browser's checker is lenient elsewhere, so do not read its silence as proof.

Try it

Set BYTE_MAX to 300 in the player and read the error the compiler prints.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27 basics 5: integer widths and their ranges
t27 basics 5: integer widths and their ranges ↗

u8, u16, u32 and i32 with their bit counts and ranges, and the error t27c gives a value too big for its type. Lesson 5 of the t27 basics course.

specs/basics/05_whole_numbers.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

Whole numbers and their widths

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/why-base-three/index.html b/apps/website/public/learn/why-base-three/index.html index 5dd0a28a6b..4532ffaeb6 100644 --- a/apps/website/public/learn/why-base-three/index.html +++ b/apps/website/public/learn/why-base-three/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Why base three

You will learn

Why ln(b) / b peaks at e, how close base 3 comes, and what 27 trits are worth in bits.

Radix economy scores a base b by E(b) = ln(b) / b, and calculus puts its peak at b = e, where E = 1 / e = 0.36788. radix_economy.t27 writes the neighbours in: E(2) = 0.34657 and E(3) = 0.36620. Base 3 reaches 0.995 of the peak, and E(3) / E(2) = 1.0566, an advantage of 5.66 percent; the spec bounds it from below at 0.054, or 5.4 percent, though the invariant is named 54_percent. In range, 27 balanced trits reach 3812798742493, above 2^41 - 1 and under 2^42 - 1, so they need 42 bits. These are arguments about digits, not a timing on a ternary machine.

Try it

Divide E_BASE3 by E_BASE2 in radix_economy.t27 by hand. Then find the invariant named 54_percent and say what number it actually asserts.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 5: why base three
GoldenFloat 5: why base three ↗

Radix economy ln(b) / b for bases 2, 3 and e, and 27 trits in bits, read from radix_economy.t27. Lesson 5 of the GoldenFloat course.

specs/math/radix_economy.t27

// SPDX-License-Identifier: Apache-2.0
@@ -412,6 +444,7 @@ 

Why base three

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/why-binary-fails/index.html b/apps/website/public/learn/why-binary-fails/index.html index 8af2b79f83..092396fa0d 100644 --- a/apps/website/public/learn/why-binary-fails/index.html +++ b/apps/website/public/learn/why-binary-fails/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Why binary fails

You will learn

Why sampling a binary bus mid-change tears it, and what the FIFO spec checks of its pointers.

Cross a multi-bit bus by sampling it in another domain and it tears: some bits arrive from before the change, some from after, and the value you read never existed. A binary counter is the worst carrier -- 7 to 8 flips four bits at once. fifo.t27 is the buffer that does this properly, and its head advances as (head_ptr + 1) % depth, with MAX_FIFO_DEPTH 65536. The recording runs the native t27c on it: 18 tests pass, 6 invariants comptime. What the tests check is fill counts and flags; the next lesson shows what they never check.

Try it

In the recording, count the passing tests and the proved invariants; then in the spec frame find the head pointer update and the maximum depth constant.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on fifo.t27 -- the FIFO stdlib, native
t27c on fifo.t27 -- the FIFO stdlib, native ↗

t27c 0.4.0 on a laptop (macOS): 18 tests of the FIFO spec pass natively, 6 invariants comptime -- push and pop state, flags, BRAM count.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Why binary fails

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/why-bridges/index.html b/apps/website/public/learn/why-bridges/index.html index 37d243d879..821d25f025 100644 --- a/apps/website/public/learn/why-bridges/index.html +++ b/apps/website/public/learn/why-bridges/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Why bridges

You will learn

Why a design grows more than one bus, and what the bridge spec checks of its own state.

A design grows more than one bus because peripherals andcompute differ: a slow register bus for the knobs, a wide one for the data. The bridge spec, FPGA_Bridge, is the crossing of this design, and bridge_initially_idle and bridge_rx_buffers_empty are two of its twenty-one tests. The recording runs t27c check: 0 errors, 0 warnings.

Try it

In the recording, find the error and warning counts; then in the spec frame find the two idle tests and count the spec's tests.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c check on bridge.t27 -- the spec compiles
t27c check on bridge.t27 -- the spec compiles ↗

t27c check typechecks the bus bridge spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -591,6 +623,7 @@ 

Why bridges

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/why-the-split-is-phi/index.html b/apps/website/public/learn/why-the-split-is-phi/index.html index 9247044491..bb7c9799af 100644 --- a/apps/website/public/learn/why-the-split-is-phi/index.html +++ b/apps/website/public/learn/why-the-split-is-phi/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Why the split is phi

You will learn

Two arguments for the phi split, and why the spec says the self-similarity one is not an optimisation.

phi_split_optimality.t27 gives two arguments and says which is which. One is self-similarity: ask that the exponent is to the mantissa as the mantissa is to both, E / M = M / (E + M). With r = E / M that reads r = 1 / (r + 1), so r^2 + r - 1 = 0 and r = (sqrt(5) - 1) / 2 = 1 / phi. The spec states that this is a defining property, not an optimisation: maximising E * M alone gives an equal split, 7 and 7 for 14 bits. The other is about rounding: round((N - 1) / phi^2) is the whole number nearest the ideal, and verify_7_7_match finds it equal to the published split for 7 of 7 formats.

Try it

Read self_similarity_proof_steps and count its steps. Then find the test that says the AM-GM split differs from the phi split, and the width it uses.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

GoldenFloat 4: why the split is phi
GoldenFloat 4: why the split is phi ↗

Two arguments for the phi split, and one that gives an equal split instead, read from phi_split_optimality.t27. Lesson 4 of the GoldenFloat course.

specs/math/phi_split_optimality.t27

// SPDX-License-Identifier: Apache-2.0
@@ -426,6 +458,7 @@ 

Why the split is phi

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/why-three/index.html b/apps/website/public/learn/why-three/index.html index 5cde9673e9..bc6ae12dd3 100644 --- a/apps/website/public/learn/why-three/index.html +++ b/apps/website/public/learn/why-three/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Why three

You will learn

Why base 3 is the cheapest whole base to write numbers in, and what that argument leaves out.

Writing a number in base b takes some digits, and every digit must tell b states apart. Price a digit at b and a number costs b times its digit count. The widget runs the spec's own cost(): every number up to 999999 costs 39 in base 3 and 40 in bases 2 and 4. Over a long range the price per digit is b / ln b, smallest at e; 3 is the whole base nearest to it. The model leaves out why binary won: two-state parts are cheap, fast and robust.

Try it

Pick each range in turn and note the cheapest base; find the range where base 2 wins, and say why the curve still favours 3.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

Why three: what a number costs in each base
Why three: what a number costs in each base ↗

Pick a range of numbers. Every base pays digits times states per digit; base 3 pays least, bases 2 and 4 tie behind it.

specs/ternary/radix_economy.t27

// SPDX-License-Identifier: Apache-2.0
@@ -182,6 +214,7 @@ 

Why three

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/wires-that-talk/index.html b/apps/website/public/learn/wires-that-talk/index.html index 4d6bc4736a..a847d85711 100644 --- a/apps/website/public/learn/wires-that-talk/index.html +++ b/apps/website/public/learn/wires-that-talk/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

Wires that talk

You will learn

What a bus is for, what the two-wire conversation of a UART costs, and what the course's opening spec checks.

A bus exists because pins are dear: two chips that must talk share wires, and the wires carry a conversation both sides agreed to. The simplest one is the UART of this lesson's spec, ZeroDSP_UART: two wires, no clock, both sides agreeing on a rate -- the spec carries UART_CLOCK_HZ at 100,000,000 and UART_BAUD_RATE at 115,200. The recording runs t27c check on the spec: 0 errors, 0 warnings, the entry bar every lesson's spec clears. The player compiles it in your browser.

Try it

In the recording, find the error and warning counts; then in the spec frame find UART_CLOCK_HZ and UART_BAUD_RATE and divide them for the bit period.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c check on uart.t27 -- the spec compiles
t27c check on uart.t27 -- the spec compiles ↗

t27c check typechecks the UART spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/uart.t27

// SPDX-License-Identifier: Apache-2.0
@@ -297,6 +329,7 @@ 

Wires that talk

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/learn/xor-needs-a-bend/index.html b/apps/website/public/learn/xor-needs-a-bend/index.html index 026133b96a..cdfba9fe67 100644 --- a/apps/website/public/learn/xor-needs-a-bend/index.html +++ b/apps/website/public/learn/xor-needs-a-bend/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiРусский
@@ -62,7 +94,7 @@

XOR needs a bend

You will learn

Why a network needs a hidden ReLU layer to compute XOR, and what one missing bend does.

XOR is 1 when exactly one input is 1, and a comment in gft_xornet.t27 says a single linear model cannot separate it. on_comb is a 2-layer net: two hidden sums, z0 and z1, each through relu, then a weighted sum of h0 and h1. It does not train: the tests pass hand-set weights, the analytic solution W=[[1,1],[1,1]], c=[0,-1], v=[1,-2]. The browser skips all 4 tests because its runner does not know assert_eq yet; the native t27c runs all 4, all pass, none vacuous. The recording runs t27c test-report, then a one-line sed that removes relu from h1 alone, and t27c test-report again: exactly one test fails, x00: at (0,0) z1 is -1.0, and the output becomes 2.0 instead of 0. git checkout puts the line back, and sha256sum prints the same hash as before the edit. Every byte in the recording was printed by the command; only the typing is staged.

Try it

In the recording, find the changed line and the test that fails; then in the spec frame work out z1 for x10, x01 and x11 and see why relu changes nothing there.

-

Open the interactive lesson →

+

Open the interactive lesson → Whole course on one page →

t27c on gft_xornet.t27 -- XOR needs a bend, native
t27c on gft_xornet.t27 -- XOR needs a bend, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; removing relu from h1 makes exactly one test fail, x00; git restores the spec.

specs/ternary/gft_xornet.t27

module GftXorNet;
@@ -213,6 +245,7 @@ 

XOR needs a bend

Open the lesson's spec in the player ↗

All lessons

+
diff --git a/apps/website/public/ru/learn/a-bar-detector/index.html b/apps/website/public/ru/learn/a-bar-detector/index.html index a966f16fdb..d0ab8160bd 100644 --- a/apps/website/public/ru/learn/a-bar-detector/index.html +++ b/apps/website/public/ru/learn/a-bar-detector/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Детектор полосы

Вы узнаете

Почему веса нейрона работают как шаблон.

Дайте нейрону веса вертикальной полосы, и его сумма будет считать совпадения минус расхождения с ними. Вертикальная полоса даёт сумму 9 и ответ +1, перевёрнутая полоса — сумму -9 и ответ -1, горизонтальная полоса и диагональ дают 1, а шум — 0. Спека урока — тот же нейрон в железе: комбинационный нейрон BitNet на одном куске из 27 тритов.

Попробовать

Меняйте вход, пока сумма не станет ровно равна порогу 5; затем найдите самое маленькое изменение вертикальной полосы, после которого нейрон перестаёт срабатывать.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A bar detector: one neuron, four patterns
A bar detector: one neuron, four patterns ↗

The weights are a vertical bar. Try every input: the bar fires +1, the inverted bar -1, other shapes and noise stay at 0, with the sums listed.

specs/ternary/comb_bitnet_neuron.t27

module CombBitnetNeuron;
@@ -121,6 +153,7 @@ 

Детектор полосы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-bend-at-zero/index.html b/apps/website/public/ru/learn/a-bend-at-zero/index.html index 79e1d1c27e..a7bc90a147 100644 --- a/apps/website/public/ru/learn/a-bend-at-zero/index.html +++ b/apps/website/public/ru/learn/a-bend-at-zero/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Излом в нуле

Вы узнаете

Почему ReLU нужен тест с отрицательным входом, прежде чем можно сказать, что у неё есть излом.

Нейрон пропускает свою сумму через функцию активации, и в gft_relu.t27 это relu(x) = max(0, x). on_comb возвращает 0 для нуля и для любого входа с битом знака, а иначе сам x. Заголовок говорит, что у ReLU точный градиент 0/1 и что 2-слойная сеть с ReLU решает XOR, а линейная модель GF-T этого не может. Браузер пропускает все 4 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который пропускает отрицательные входы, и relu становится тождеством, прямой линией, и снова t27c test-report. Падает ровно один тест, negz; больше ни у одного теста нет отрицательного входа. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и значение, которого ждёт negz; затем найдите в спеке комментарий на этой строке и проверьте, описывает ли он код после замены.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_relu.t27 -- a bend at zero, native
t27c on gft_relu.t27 -- a bend at zero, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; letting negative inputs through makes exactly one test fail, negz; git restores the spec.

specs/ternary/gft_relu.t27

module GftRelu;
@@ -92,6 +124,7 @@ 

Излом в нуле

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-boundary-of-real-files/index.html b/apps/website/public/ru/learn/a-boundary-of-real-files/index.html index 2a656708bb..680cbaf322 100644 --- a/apps/website/public/ru/learn/a-boundary-of-real-files/index.html +++ b/apps/website/public/ru/learn/a-boundary-of-real-files/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Граница из настоящих файлов

Вы узнаете

Какие предложенные пути задача может забронировать и почему один выдуманный путь останавливает всё оформление.

Граница задачи — это бронь: пока пчела работает, другие пчёлы эти файлы не берут. Поэтому неверная граница хуже отсутствующей: она держит файлы, которые работе не принадлежат. path_accepted принимает любой существующий файл, а новый — только если существует его папка, задача его упоминает и язык разрешён правилом only-t27. shape_lands возвращает оформление в задачу, только если все разделы на месте, путей от 1 до 12 и ни один не отклонён.

Попробовать

Сделайте два красных пути зелёными, меняя только то, что может быть правдой; затем оставьте раздел недописанным и посмотрите на ворота.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A boundary: which files a task may reserve
A boundary: which files a task may reserve ↗

Four paths a model proposed for an issue. Tap what is true of each: the spec accepts or refuses it, and a shape lands only when every path holds.

specs/queen/shaping.t27

// SPDX-License-Identifier: Apache-2.0
@@ -198,6 +230,7 @@ 

Граница из настоящих файлов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-build-receipt/index.html b/apps/website/public/ru/learn/a-build-receipt/index.html index b007789823..bb2403467d 100644 --- a/apps/website/public/ru/learn/a-build-receipt/index.html +++ b/apps/website/public/ru/learn/a-build-receipt/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сборка по пунктам

Вы узнаете

Каждая стадия от спеки до битстрима — с временем, инструментом и хешем.

Целая сборка от спеки t27 до битстрима Artix-7, расписанная как чек из магазина: каждая стадия, инструмент и его версия, затраченное время и sha256 того, что она записала. Нигде нет Vivado. Когда число в чеке можно проверить, любой может пересобрать и сравнить хеш.

Попробуйте

Прочитайте чек: какая стадия шла дольше всех и какой инструмент её выполнял? В спеке RECEIPT_KINDS называет два вида чека: какой из них — только сборка и какая запись в ERRORS ловит его, когда он выдаёт себя за другой?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Build receipt: t27 spec to XC7A200T bitstream, no Vivado
Build receipt: t27 spec to XC7A200T bitstream, no Vivado ↗

One real open-flow build itemised like a shop receipt: each stage from a t27 spec to an Artix-7 200T bitstream with its time, tool version, output size and sha256.

specs/fpga/adapter.t27

// SPDX-License-Identifier: Apache-2.0
@@ -168,6 +200,7 @@ 

Сборка по пунктам

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-correlator-finds-the-frame/index.html b/apps/website/public/ru/learn/a-correlator-finds-the-frame/index.html index cfbda55e5d..c9f3939ee0 100644 --- a/apps/website/public/ru/learn/a-correlator-finds-the-frame/index.html +++ b/apps/website/public/ru/learn/a-correlator-finds-the-frame/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Коррелятор находит кадр

Вы узнаете

Как коррелятор Баркера-13 находит начало кадра и сколько перевёрнутых чипов он выдерживает.

Кадр начинается с 13 чипов кода Баркера, корреляция которого с собой равна 13 при совпадении и не больше 1 при сдвиге. Спека модема bpsk.t27 вталкивает каждый принятый чип в окно из 13 чипов и коррелирует его; захват происходит на 9, с запасом между боковым лепестком и пиком. Виджет исполняет эти самые функции на потоке из 32 чипов: пик стоит на 13 там, где совпадает преамбула, перевёрнутая несущая даёт -13, а каждый перевёрнутый чип в окне снижает пик на 2.

Попробовать

Переверните два чипа преамбулы и проверьте, что захват остаётся; затем найдите, сколько переворотов срывают захват.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A correlator finds the frame: Barker-13 in a stream of chips
A correlator finds the frame: Barker-13 in a stream of chips ↗

Slide a Barker-13 preamble through a stream of chips and watch the correlator peak at 13 where it lines up. Flip chips to add noise; see when the lock fails.

specs/fpga/bpsk.t27

// SPDX-License-Identifier: Apache-2.0
@@ -282,6 +314,7 @@ 

Коррелятор находит кадр

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-deploy-mid-flight/index.html b/apps/website/public/ru/learn/a-deploy-mid-flight/index.html index 9190f525bc..a4f63fe475 100644 --- a/apps/website/public/ru/learn/a-deploy-mid-flight/index.html +++ b/apps/website/public/ru/learn/a-deploy-mid-flight/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Деплой на лету

Вы узнаете

Что передеплой делает с пчелой, ревью, раундом, фоновой работой и ожиданием.

Каждое слияние передеплоивает Королеву, а в этот момент идёт работа. drain.t27 её сортирует. Раунд, шаг фоновой работы и строка ожидания — это строки, которые хранит база: процесс их оставляет, и следующий продолжает. Ревью останавливается: остановка теряет не больше одного ревью, и его делают заново. Пчелу держат, потому что сделанное ею живёт в её разговоре; на потолке, drain_cap_seconds, сегодня 1800 с, её возвращают, а работу сохраняют в её ветку.

Попробовать

Протяните ожидание от 0 до потолка и посмотрите, как меняется строка пчелы; затем сократите дренаж платформы до 1000 с.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A deploy mid-flight: what happens to a running bee
A deploy mid-flight: what happens to a running bee ↗

The Queen is redeployed while work runs. Drag how long the drain has waited: a bee is held to the cap and then handed back, a review is stopped, a round and a job are left to the store.

specs/queen/drain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -389,6 +421,7 @@ 

Деплой на лету

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-dot-product-in-wires/index.html b/apps/website/public/ru/learn/a-dot-product-in-wires/index.html index 3cb990f455..436626c9de 100644 --- a/apps/website/public/ru/learn/a-dot-product-in-wires/index.html +++ b/apps/website/public/ru/learn/a-dot-product-in-wires/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Скалярное произведение из проводов

Вы узнаете

Во что on_comb превращает спеку и как один неверный знак в tmul проявляется ровно в одном тесте.

on_comb в comb_ternary_dot.t27 комбинационный: сгенерированный Verilog подаёт result одним assign без регистра, и выход следует за входами. Он складывает tp по всем 27 дорожкам a и b, а tp вызывает tmul, который возвращает 0, если хоть один трит равен Z, +1 при совпадении и -1 иначе. Поэтому N на N даёт +1, и dot_all_n_x_all_n ждёт 27. Браузер пропускает все 4 теста, потому что пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись меняет return -1 на return 1 в строке 22, и падает ровно один тест, dot_all_n_x_all_p, — тот, где N стоит против P. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку tmul и упавший тест; затем найдите в спеке dot_all_n_x_all_n и объясните, почему он ждёт 27, а не -27.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on comb_ternary_dot.t27 -- The dot product as wires, native
t27c on comb_ternary_dot.t27 -- The dot product as wires, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 4 tests pass natively; tmul returning +1 for mismatched signs fails exactly one test, dot_all_n_x_all_p; git restores the spec.

specs/ternary/comb_ternary_dot.t27

module CombTernaryDot;
@@ -111,6 +143,7 @@ 

Скалярное произведение из проводов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-float-cut-by-phi/index.html b/apps/website/public/ru/learn/a-float-cut-by-phi/index.html index 2ca8198082..b2b569a46f 100644 --- a/apps/website/public/ru/learn/a-float-cut-by-phi/index.html +++ b/apps/website/public/ru/learn/a-float-cut-by-phi/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Число с плавающей точкой, разрезанное по p

Вы узнаете

Как одно правило, E = round((N - 1) / phi^2), делит каждую ширину GoldenFloat на знак, порядок и мантиссу.

Число с плавающей точкой тратит биты на три поля: один бит знака, порядок для диапазона и мантиссу для точности. IEEE 754 выбирает это деление комитетом для каждой ширины. GoldenFloat использует одно правило для всех: из N - 1 битов после знака round((N - 1) / phi^2) уходят в порядок, остальные в мантиссу, так что отношение E / M держится около 1 / phi, примерно 0.618. Спека семейства перечисляет 17 ширин от GF4 до GF1024, и GF16 она отмечает основным.

Попробуйте

Запустите тесты goldenfloat_family.t27 и найдите тот, что считает семейство. Затем найдите, какой формат спека отмечает основным, и тест, который говорит, что он один.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 1: one rule for every width
GoldenFloat 1: one rule for every width ↗

Five of the 17 GoldenFloat widths, read from goldenfloat_family.t27. Lesson 1 of the GoldenFloat course.

specs/numeric/goldenfloat_family.t27

// SPDX-License-Identifier: Apache-2.0
@@ -627,6 +659,7 @@ 

Число с плавающей точкой, разрезанное по p

Открыть спеку урока в плеере ↗

Все уроки

+

diff --git a/apps/website/public/ru/learn/a-key-rests/index.html b/apps/website/public/ru/learn/a-key-rests/index.html index 7d602356c9..1220c1ae06 100644 --- a/apps/website/public/ru/learn/a-key-rests/index.html +++ b/apps/website/public/ru/learn/a-key-rests/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Ключ отдыхает

Вы узнаете

Сколько отклонённый ключ отдыхает, прежде чем пчела сможет взять его снова.

Временный отказ даёт ключу отдохнуть COOL_BASE_SECONDS, 15 с, вдвое больше за каждый отказ подряд и не больше COOL_CAP_SECONDS, 240 с: 15, 30, 60, 120, 240. Исчерпанная квота или отклонённый ключ закрывают его на KEY_BREAK_SECONDS, 1800 с. Всё это даёт cooldown_seconds. Отдых короткий, чтобы 34 ключа никогда не отдыхали все сразу во время минутного всплеска, как на 2026-10-17.

Попробовать

Найдите число отказов, после которого отдых перестаёт расти; затем переключите на квоту и прочитайте отдых.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

How long a refused key rests
How long a refused key rests ↗

A transient refusal rests the key 15 s, doubled per strike in a row, never past 240 s. A spent quota or a refused key closes it for 1800 s. Drag the strikes.

specs/queen/key_failover.t27

// SPDX-License-Identifier: Apache-2.0
@@ -451,6 +483,7 @@ 

Ключ отдыхает

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-loss-in-bits/index.html b/apps/website/public/ru/learn/a-loss-in-bits/index.html index f2b5b94cd0..80cb809290 100644 --- a/apps/website/public/ru/learn/a-loss-in-bits/index.html +++ b/apps/website/public/ru/learn/a-loss-in-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Потеря в битах

Вы узнаете

Как потеря -log2(p) оценивает догадку в битах и почему безошибочная догадка должна стоить ровно 0.

Обучение начинается с числа, которое говорит, насколько неверной была догадка. gft_nll.t27 берёт p, вероятность, которую модель дала верному классу, и возвращает -log2(p): p = 1.0 стоит 0, p = 0.5 стоит 1 бит, а p = 0.25 стоит 2. on_comb — это neg(log2v(p)), и neg переворачивает бит знака, но для 0 возвращает 0. Одна строка заголовка всё ещё говорит, что на выходе log2(x); код возвращает его с обратным знаком. Браузер пропускает все 3 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 3, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который заставляет neg возвращать 65536 для 0, ноль с поставленным битом знака, и снова t27c test-report: падает ровно один тест, perfect. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке строку заголовка, где сказано, что на выходе log2(x), и сравните её с on_comb.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_nll.t27 -- a loss in bits, native
t27c on gft_nll.t27 -- a loss in bits, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 3 tests pass natively, none vacuous; a zero with the sign bit set from neg makes exactly one test fail, perfect; git restores the spec.

specs/ternary/gft_nll.t27

module GftNll;
@@ -170,6 +202,7 @@ 

Потеря в битах

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-model-on-the-board/index.html b/apps/website/public/ru/learn/a-model-on-the-board/index.html index 3b72e42765..5b701bfd0a 100644 --- a/apps/website/public/ru/learn/a-model-on-the-board/index.html +++ b/apps/website/public/ru/learn/a-model-on-the-board/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Таблицы модели на плате

Вы узнаете

Как компьютер кормит плату работой через последовательный мост, почему важен размер окна и что плата посчитала.

Арифметику делает плата; компьютер отправляет ей работу через последовательный USB-мост. Ответы платы ждут в маленьком приёмном буфере микросхемы моста, и если держать в полёте больше запросов, чем помещается их ответов, ответы теряются. Окно поменьше убрало потери и не замедлило прогон. По этой линии плата перемножила все троичные матрицы весов небольшой языковой модели, и каждая строка совпала с эталоном бит в бит. Сам текст генерирует Mac, который делает всё, кроме троичных скалярных произведений: плата — это калькулятор, а не вся модель.

Попробуйте

Тяните окно, пока ведро не переполнится, и запомните самое большое окно, которое помещается; затем сравните два настоящих прогона. В спеке weighted применяет вес только по знаку; найдите apply_alpha, где слой умножает один раз, и тест, который показывает, что он округляет вниз.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The bucket under the tap: a 512-byte UART buffer and 19-byte answers
The bucket under the tap: a 512-byte UART buffer and 19-byte answers ↗

Drag the number of requests in flight and watch the answers fill a CP2102N's 512-byte receive buffer, then read the measured runs on the AX7203 board.

specs/igla/race/unit_weights_node.t27

// SPDX-License-Identifier: Apache-2.0
@@ -314,6 +346,7 @@ 

Таблицы модели на плате

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-neuron-in-chunks/index.html b/apps/website/public/ru/learn/a-neuron-in-chunks/index.html index 03fcb2b59f..84b01c887b 100644 --- a/apps/website/public/ru/learn/a-neuron-in-chunks/index.html +++ b/apps/website/public/ru/learn/a-neuron-in-chunks/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Нейрон по кускам

Вы узнаете

Как нейрон с числом входов больше 27 складывает скалярные произведения кусок за куском и почему важен тест без кусков.

Один упакованный кусок вмещает 27 тритов, поэтому широкому нейрону нужно несколько. neuronN в bitnet_neuron_nchunk.t27 принимает до 8 кусков активаций и весов, складывает dot27 для nchunks пар, начиная с куска 0, и квантует сумму. Браузер пропускает все 11 тестов, потому что пока не знает assert_eq; нативный t27c запускает все 11, все проходят, ни один не пустой. Запись меняет границу цикла в строке 36 с nchunks на 1, и нейрон всегда читает ровно один кусок. Остальные тесты нейрона заполняют все куски одинаково, и одного куска хватает, чтобы оказаться по ту же сторону порога. Падает ровно один тест, neuron_zero_chunks, который не даёт ни одного куска и ждёт Z. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи строку цикла до и после изменения; затем найдите в спеке neuron_two_chunks и объясните, почему та же ошибка его не ломает.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on bitnet_neuron_nchunk.t27 -- A neuron over N chunks, native
t27c on bitnet_neuron_nchunk.t27 -- A neuron over N chunks, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 11 tests pass natively; stopping the chunk loop after one chunk fails exactly one test, neuron_zero_chunks; git restores the spec.

specs/ternary/bitnet_neuron_nchunk.t27

module BitnetNeuronN;
@@ -139,6 +171,7 @@ 

Нейрон по кускам

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-pass-that-checked-nothing/index.html b/apps/website/public/ru/learn/a-pass-that-checked-nothing/index.html index aa5cc7b450..1d87e73ce5 100644 --- a/apps/website/public/ru/learn/a-pass-that-checked-nothing/index.html +++ b/apps/website/public/ru/learn/a-pass-that-checked-nothing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Прогон, который ничего не проверил

Вы узнаете

Что такое пустой проход, почему зелёный отчёт может его скрыть и как подложенная ошибка отличает настоящие проверки от пустых.

Нативный t27c запускает все 13 тестов gfternary.t27, и все 13 проходят. Тот же отчёт печатает строку, которой нет у большинства инструментов: 8 из 13 прошли, не выполнив ни одного assert во время работы. Пустой проход — не ложь, но и не доказательство. 5 инвариантов доказываются, пока спека компилируется, и один из них утверждает только true — это заглушка. Поэтому запись подкладывает ошибку: зарезервированный код 11 больше не сворачивается в ноль. Падает ровно один тест — тот, что написан для этого правила. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите строку о пустых проходах и тест, который ломает подложенная ошибка; затем откройте спеку и найдите инвариант, который утверждает только true.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gfternary.t27 -- phi-scaled ternary weights, native
t27c on gfternary.t27 -- phi-scaled ternary weights, native ↗

t27c 0.4.0 and zig 0.16.0 on the t27c lab (Railway), spec at t27 5ff0ec512: 13 tests pass natively, 8 of them with no runtime assert; dropping the reserved-code fold makes exactly one test fail; git restores the spec.

specs/numeric/gfternary.t27

// SPDX-License-Identifier: Apache-2.0
@@ -452,6 +484,7 @@ 

Прогон, который ничего не проверил

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-recurrent-cell/index.html b/apps/website/public/ru/learn/a-recurrent-cell/index.html index 6d35e12c8b..07fe35dd19 100644 --- a/apps/website/public/ru/learn/a-recurrent-cell/index.html +++ b/apps/website/public/ru/learn/a-recurrent-cell/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Рекуррентная ячейка

Вы узнаете

Как рекуррентная ячейка переносит состояние от шага к шагу и почему эта память затухает.

Предложение приходит по одному слову, и рекуррентная ячейка переносит состояние h от шага к шагу: h' = tanh(W_x x + W_h h + b). В крошечной ячейке спеки W_x равен 1, а W_h 0.5, поэтому один импульс даёт 0.7616, 0.3634 и 0.1797: память о нём примерно вдвое слабеет каждый шаг. Второй импульс на шаге 3 поднимает h до 0.7968, чуть выше, чем начинался одиночный импульс, потому что старая память ещё там. После 8 шагов остаётся лишь 0.0466. Это затухание и есть причина, по которой простые ячейки забывают длинный контекст. Спека rnn_cell.t27 вычисляет каждый шаг.

Попробовать

Загрузите один импульс и прочитайте, за сколько шагов он падает ниже 0.1; затем сделайте вход чередующимся.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Recurrent cells: how a network remembers a moment ago
Recurrent cells: how a network remembers a moment ago ↗

Tap the inputs of eight steps: the cell feeds its own last output back, h' = tanh(x + 0.5 h), so every pulse echoes on and fades by about half a step. Two pulses add up.

specs/ml/recurrent/rnn_cell.t27

// SPDX-License-Identifier: Apache-2.0
@@ -258,6 +290,7 @@ 

Рекуррентная ячейка

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-refused-key/index.html b/apps/website/public/ru/learn/a-refused-key/index.html index ec47e7b8dc..a98797a3a4 100644 --- a/apps/website/public/ru/learn/a-refused-key/index.html +++ b/apps/website/public/ru/learn/a-refused-key/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Отклонённый ключ

Вы узнаете

Как Королева сортирует отказ провайдера: временный, квота, доступ или неверный запрос.

Пчёлы обращаются к моделям по ключам, и ключи отклоняют. key_failover.t27 сортирует каждый отказ функцией error_kind. Код z.ai в теле ответа важнее статуса HTTP, потому что z.ai отвечает одним и тем же 429 и на исчерпанную квоту, и на временную перегрузку: код 1305 временный, 1113 — квота. Отсутствие ответа — тоже временный отказ. Отказ по квоте или доступу закрывает ключ, а в счёт задачи идёт только неверный запрос.

Попробовать

Сравните 429 с кодами 1308 и 1312; затем прочитайте, что значит отсутствие ответа.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A refused key: transient, quota, auth or a bad request
A refused key: transient, quota, auth or a bad request ↗

Pick the HTTP status and the z.ai code a bee got back. error_kind sorts the refusal, and the grid colours every status against every code the same way.

specs/queen/key_failover.t27

// SPDX-License-Identifier: Apache-2.0
@@ -451,6 +483,7 @@ 

Отклонённый ключ

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-sign-is-one-bit/index.html b/apps/website/public/ru/learn/a-sign-is-one-bit/index.html index 16bd969fac..176c892e76 100644 --- a/apps/website/public/ru/learn/a-sign-is-one-bit/index.html +++ b/apps/website/public/ru/learn/a-sign-is-one-bit/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Знак — это один бит

Вы узнаете

Как умножение чисел со знаком ставит знак произведения и какой тест замечает, когда знак не ставится никогда.

Модули с 1 по 4 были о том, как хранить числа: ячейка T27, байт масштаба OCP MX, тернарные веса с масштабом фи и TNF; этот модуль заставляет их считать. gft_smul.t27 использует биты tnf17.t27: 1.0 — это 20480, а -1.0 — это 86016, те же биты плюс бит знака 65536. smul ставит знак, когда знаки входов различаются, а величину отдаёт magmul. Браузер пропускает все 3 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 3, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который делает знак всегда равным 0, и снова t27c test-report: падает ровно один тест, m2, который умножает 1.0 на -1.0. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке m1 и m3 и поймите, почему знак, который всегда равен 0, не может их сломать.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_smul.t27 -- a sign is one bit, native
t27c on gft_smul.t27 -- a sign is one bit, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 3 tests pass natively, none vacuous; a sign that is always 0 makes exactly one test fail, m2; git restores the spec.

specs/ternary/gft_smul.t27

module GftSmul;
@@ -190,6 +222,7 @@ 

Знак — это один бит

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-small-program/index.html b/apps/website/public/ru/learn/a-small-program/index.html index c6ba0be915..6614339232 100644 --- a/apps/website/public/ru/learn/a-small-program/index.html +++ b/apps/website/public/ru/learn/a-small-program/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Маленькая законченная программа

Вы узнаете

Как части этого курса складываются в одну спеку, которая становится схемой.

В спеке урока есть строка module, константа ширины, тестовые значения и on_comb — функция двух входов u8. gen-verilog превращает её в модуль, у которого порты — такт, сброс и разрешение, два 8-битных входа a и b, выход ready и 8-битный выход result. Строка assign задаёт result из on_comb, так что сама сумма не ждёт фронта такта. Тесты проверяют примеры сумм как константы; прогон на сайте не вызывает on_comb, так что проверка самой схемы остаётся симулятору.

Попробуйте

Откройте вкладку verilog спеки урока в плеере и найдите строки input, output и assign.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 26: an adder in t27 and its Verilog ports
t27 basics 26: an adder in t27 and its Verilog ports ↗

An 8-bit adder written in t27, with the Verilog ports and assign line the real compiler wrote for it. Lesson 26 of the t27 basics course.

specs/basics/26_a_small_program.t27

// SPDX-License-Identifier: Apache-2.0
@@ -87,6 +119,7 @@ 

Маленькая законченная программа

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-tasks-life/index.html b/apps/website/public/ru/learn/a-tasks-life/index.html index 6aad60877d..7ea72e0d6a 100644 --- a/apps/website/public/ru/learn/a-tasks-life/index.html +++ b/apps/website/public/ru/learn/a-tasks-life/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Жизнь задачи

Вы узнаете

Через какие состояния проходит запущенная задача и какие события допустимы в каждом.

dispatch.t27 — жизненный цикл задачи у Королевы, цикл, который выбирает, запускает, завершает, проверяет и отпускает работу. У задачи 12 состояний и 16 событий. next_state отвечает на каждую пару, а 99 значит, что событие в этом состоянии недопустимо: вердикт не доходит до работающей задачи, а снятие — до завершённой. После вердикта возврат ждёт свой порог и отпускается; даже принятую работу возвращают, если CI краснеет ниже потолка.

Попробовать

Проведите задачу от none до accept; затем сделайте CI красным на потолке и найдите выход, который остаётся.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A task's life: the Queen's state machine
A task's life: the Queen's state machine ↗

Twelve states and sixteen events. Tap an event: next_state moves the task, and every event it would refuse is greyed out.

specs/queen/dispatch.t27

// SPDX-License-Identifier: Apache-2.0
@@ -662,6 +694,7 @@ 

Жизнь задачи

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-ternary-alu/index.html b/apps/website/public/ru/learn/a-ternary-alu/index.html index 29385c46a6..b52448a8d7 100644 --- a/apps/website/public/ru/learn/a-ternary-alu/index.html +++ b/apps/website/public/ru/learn/a-ternary-alu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Троичное АЛУ

Вы узнаете

Как сложение, вычитание, смена знака и сравнение работают на 9-тритных регистрах.

АЛУ этого виджета собрано из пройденного: ADD — сумматор со сквозным переносом, SUB прибавляет b с перевёрнутыми тритами, NEG — один лишь переворот, CMP отвечает одним тритом. Регистры из девяти тритов хранят от -9841 до 9841, и результат за этими пределами отмечается как переполнение. Спека урока, tri27_machine.t27, описывает машину TRI-27 так, как её исполняет эмулятор Trinity.

Попробовать

Вычтите 13 из 40 и прочитайте плитки; затем вызовите переполнение сумматора самой маленькой парой, какую найдёте.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A ternary ALU built from this course's adders
A ternary ALU built from this course's adders ↗

Add, subtract, negate and compare 9-trit registers. Subtraction is a flip and an add; an overflow past 9 trits is flagged.

specs/isa/tri27_machine.t27

// SPDX-License-Identifier: Apache-2.0
@@ -533,6 +565,7 @@ 

Троичное АЛУ

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-test-block/index.html b/apps/website/public/ru/learn/a-test-block/index.html index bddbf44a05..49eae0fcd8 100644 --- a/apps/website/public/ru/learn/a-test-block/index.html +++ b/apps/website/public/ru/learn/a-test-block/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Блок test

Вы узнаете

Как пишется блок test и что сообщает упавший assert.

Блок test начинается ключевым словом test и именем и держит в фигурных скобках строки assert. Каждый assert принимает выражение, которое обязано быть истинным. Когда одно ложно, отчёт называет тест и номер assert, например assert #1 is false. Тесты спеки — это её утверждения о себе самой, поэтому каждая спека курса на этом сайте их несёт.

Попробуйте

Нарочно сломайте тест, поменяв DAYS, и прочитайте строку отказа.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 10: a test block, passing and failing
t27 basics 10: a test block, passing and failing ↗

A t27 test block and the report it gives when it passes and when an assert is false. Lesson 10 of the t27 basics course.

specs/basics/10_a_test_block.t27

// SPDX-License-Identifier: Apache-2.0
@@ -80,6 +112,7 @@ 

Блок test

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-tiny-layer/index.html b/apps/website/public/ru/learn/a-tiny-layer/index.html index 81eae673bf..53c0d45e97 100644 --- a/apps/website/public/ru/learn/a-tiny-layer/index.html +++ b/apps/website/public/ru/learn/a-tiny-layer/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Маленький слой

Вы узнаете

Как несколько нейронов, читающих один вход, описывают его парой тритов.

Слой — это несколько нейронов, читающих один и тот же вход. Три детектора — вертикальный, горизонтальный и диагональный — превращают картинку 3 x 3 в три выходных трита: вертикальная полоса даёт +1, 0, 0. Сложите слои, и получится сеть; спека урока — слой из 4 нейронов в одном комбинационном модуле, а курс ai-numbers доводит это до целой сети на плате.

Попробовать

Нарисуйте картинку, на которую сработают сразу два нейрона; затем такую, на которую все три ответят -1.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A layer of three ternary neurons
A layer of three ternary neurons ↗

Three neurons share one input: a vertical, a horizontal and a diagonal detector. Draw on the input and read three output trits.

specs/ternary/comb_bitnet_layer.t27

module CombBitnetLayer;
@@ -130,6 +162,7 @@ 

Маленький слой

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-whole-network/index.html b/apps/website/public/ru/learn/a-whole-network/index.html index 3416283d6d..e85d4d00f4 100644 --- a/apps/website/public/ru/learn/a-whole-network/index.html +++ b/apps/website/public/ru/learn/a-whole-network/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Целая сеть

Вы узнаете

Как части этого курса складываются в одну небольшую сеть и что её тесты и её Verilog ещё оставляют открытым.

mlp2 в bitnet_mlp.t27 — целая сеть: 3 нейрона читают вход, pack3 упаковывает их 3 трита в скрытый кусок, и 2 нейрона превращают его в 2 выходных трита. Курс прошёл от форматов чисел и арифметики к нейрону, обучению, тернарным весам и чипу; здесь есть нейрон, веса и вход on_comb, а обучения нет. Нативный t27c запускает все 4 теста, все проходят, ни один не пустой; браузер их пропускает, и ни один не вызывает mlp2. Сгенерированный Verilog помечает цикл по кускам в neuronN как NOT UNROLLED, и его примечание говорит, что yosys такое отвергает, так что это ещё не чип. Запись переносит третий скрытый трит из бита 4 в бит 3 в строке 39, и падает ровно один тест, pack3_zzz. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи строку pack3 до и после изменения; затем откройте в спеке вкладку Code, выберите verilog и найдите в neuronN цикл с пометкой NOT UNROLLED.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on bitnet_mlp.t27 -- A whole ternary network, native
t27c on bitnet_mlp.t27 -- A whole ternary network, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 4 tests pass natively; pack3 writing its third trit one bit low fails exactly one test, pack3_zzz; git restores the spec.

specs/ternary/bitnet_mlp.t27

module BitnetMlp;
@@ -140,6 +172,7 @@ 

Целая сеть

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/a-word-of-27/index.html b/apps/website/public/ru/learn/a-word-of-27/index.html index 1e5cc103b2..254b0da4f3 100644 --- a/apps/website/public/ru/learn/a-word-of-27/index.html +++ b/apps/website/public/ru/learn/a-word-of-27/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Слово из 27 тритов

Вы узнаете

Сколько бит нужно слову из 27 тритов и насколько плотно оно их использует.

k тритам нужно наименьшее число бит b, при котором 2^b не меньше 3^k. Слово из 27 тритов, размер регистра TRI-27, покрывает плюс-минус 3812798742493 и требует 43 бита. Доля занятых бит растёт пилой к 1 по мере роста слова: широкие слова почти ничего не теряют, узкие — до пятой части.

Попробовать

Найдите длину слова больше одного трита с худшей долей и длину, ближайшую к 100%.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A word of 27 trits and the 43 bits it needs
A word of 27 trits and the 43 bits it needs ↗

Slide the word length. k trits need the fewest bits b with 2^b >= 3^k; at 27 trits that is 43 bits, and the share in use approaches 100 percent.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Слово из 27 тритов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/adam/index.html b/apps/website/public/ru/learn/adam/index.html index 14f378e07b..c6a29309f5 100644 --- a/apps/website/public/ru/learn/adam/index.html +++ b/apps/website/public/ru/learn/adam/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Adam: момент и масштаб

Вы узнаете

Как Adam соединяет момент со скользящим масштабом и почему поправка смещения делает шаг 1 фиксированного размера.

Adam соединяет обе идеи: m, скользящее среднее градиента, как в моменте, и v, скользящее среднее его квадрата, как в RMSProp; шаг равен lr m / sqrt(v). Оба начинают с 0 и поначалу слишком малы, поэтому Adam делит их на 1 - beta^t, и на шаге 1 это делает сдвиг ровно lr, умноженным на знак градиента: градиенты 2, -40 и 0.5 сдвигают свои веса на одинаковые 0.001. На чаше спеки (x - 3)^2 при lr 0.1 Adam поднимается от 0, перелетает примерно до 3.18 и успокаивается на 3.00005 к шагу 200. Спека adam.t27 вычисляет каждый шаг.

Попробовать

Дайте трём градиентам очень разные размеры и прочитайте веса после шага 1; затем найдите, где путь достигает вершины.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Adam: the optimizer most networks are trained with
Adam: the optimizer most networks are trained with ↗

Watch Adam carry a weight from 0 to the minimum at 3, then set three gradients of any size: the bias correction makes the first step lr times their sign, whatever their size.

specs/ml/optimizer/adam.t27

// SPDX-License-Identifier: Apache-2.0
@@ -225,6 +257,7 @@ 

Adam: момент и масштаб

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/add-it-up-every-clock/index.html b/apps/website/public/ru/learn/add-it-up-every-clock/index.html index a86ad21888..ef82e4abd1 100644 --- a/apps/website/public/ru/learn/add-it-up-every-clock/index.html +++ b/apps/website/public/ru/learn/add-it-up-every-clock/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Складывать на каждом такте

Вы узнаете

Что on_clock добавляет к скалярному произведению и почему тесты этой спеки не доходят до регистра.

stream_ternary_mac.t27 берёт тот же dot27 и добавляет регистр acc и on_clock, который прибавляет dot27(a, b) к acc. on_clock тактируемый: он срабатывает раз на фронт такта, а acc хранит значение между фронтами. В сгенерированном Verilog низкий rst_n обнуляет acc, а acc меняется, только пока en высокий; в самой спеке en нет. Нативный t27c запускает все 4 теста, все проходят, ни один не пустой; браузер их пропускает: он не знает assert_eq. Все 4 вызывают dot27, ни один не запускает on_clock, так что строку накопления проверяет виджет test-waves, а не тест. Запись сужает маску для a в строке 26 с 3 до 1, и P в a читается как N: падает ровно один тест, dot_all_p_x_all_p. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую маску и упавший тест; затем найдите в спеке on_clock и убедитесь, что ни один тест его не вызывает.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on stream_ternary_mac.t27 -- Accumulate on the clock, native
t27c on stream_ternary_mac.t27 -- Accumulate on the clock, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 4 tests pass natively; a lane mask that loses a bit fails exactly one test, dot_all_p_x_all_p; git restores the spec.

specs/ternary/stream_ternary_mac.t27

module StreamTernaryMac;
@@ -120,6 +152,7 @@ 

Складывать на каждом такте

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/address-decode/index.html b/apps/website/public/ru/learn/address-decode/index.html index 43fe821a11..c3f84ad092 100644 --- a/apps/website/public/ru/learn/address-decode/index.html +++ b/apps/website/public/ru/learn/address-decode/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Дешифрация адреса

Вы узнаете

Сколько адресных бит стоит количество периферии и что проверяет стенд моста.

Адресация на APB — вопрос бит: сколько слуг сидит за мостом, столько бит дешифрация тратит. Спека отвечает по счёту — addr_bits_for_1_peripheral, addr_bits_for_4_peripherals, addr_bits_for_8_peripherals — а её тестбенч гоняет результат: test_reset_state, test_apb_write, test_apb_read, test_write_read_roundtrip, test_multiple_apb_writes, восемь тестов. Запись опускает тестбенч-спеку моста APB в Verilog.

Попробовать

В записи найдите тесты стенда; затем в спеке вычислите, сколько адресных бит спека тратит на 8 периферий.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on apb_bridge_tb.t27 -- the testbench as RTL
t27c gen-verilog on apb_bridge_tb.t27 -- the testbench as RTL ↗

The APB bridge testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/apb_bridge_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -226,6 +258,7 @@ 

Дешифрация адреса

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/aging-a-label/index.html b/apps/website/public/ru/learn/aging-a-label/index.html index 3b5cf7fa3a..eccc3e3555 100644 --- a/apps/website/public/ru/learn/aging-a-label/index.html +++ b/apps/website/public/ru/learn/aging-a-label/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Старение метки

Вы узнаете

Как задача с меткой поднимается с возрастом и почему только на один уровень.

Без меток Королева берёт задачи в том порядке, в котором их выдаёт GitHub. priority.t27 добавляет четыре уровня: critical, high, normal и low; меньший идёт раньше, а задача без метки считается normal. Задача с меткой поднимается на уровень через AGING_DAYS, 14 дней, и не больше чем на MAX_AGING_STEPS, 1 уровень, так что low доходит до normal на 14-й день и там остаётся. High и critical не стареют. Линию в виджете вычисляет effective_level.

Попробовать

Найдите день, когда задача с меткой low поднимается; затем снимите метку и дотяните до 60-го дня.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Aging: how long a labelled low issue waits
Aging: how long a labelled low issue waits ↗

Pick a level, label it or not, and drag its age: a labelled issue gains one level after 14 days, at most one, and never reaches critical.

specs/queen/priority.t27

// SPDX-License-Identifier: Apache-2.0
@@ -231,6 +263,7 @@ 

Старение метки

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/ai-numbers/all/card.png b/apps/website/public/ru/learn/ai-numbers/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..3be28f5a1e3edd8447cc5c1dce9ccb35eab7caec GIT binary patch literal 45899 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 PV~Z}>=w7+zgRp-C29_!u literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/ai-numbers/all/index.html b/apps/website/public/ru/learn/ai-numbers/all/index.html new file mode 100644 index 0000000000..4d0123bde1 --- /dev/null +++ b/apps/website/public/ru/learn/ai-numbers/all/index.html @@ -0,0 +1,482 @@ + + + + + + +ИИ-числа на t27: от форматов чисел до тернарной сети: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

ИИ-числа на t27: от форматов чисел до тернарной сети

+

Он продолжает курс по FPGA с того места, где тот заканчивается. Каждый урок открывает настоящий инструмент или запись t27c и Zig на настоящей машине рядом со спекой, которую можно запустить в браузере.

+

Курс 2, 27 уроков, в каждом виджет и спека t27: наш собственный формат чисел, блочные форматы OCP MX, которыми пользуются ИИ-чипы, тернарные веса и Ternary Network Float, затем арифметика со знаком, части нейрона, шаг обучения, тернарные нейроны BitNet и тернарный MAC как логика. Каждый новый урок подкладывает одну ошибку и показывает тест, который её ловит.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

Пройдено 0 из 27

+

Открыть интерактивный курс →

+
+

Модуль 1 · Лаборатория: наши исследования

Свой формат чисел, честная таблица результатов и таблицы модели, перемноженные на плате.

+
+
01

Урок 1 из 27

T27: наш собственный формат чисел

+
+

Вы узнаетеКак три трита дают больше уровней, чем 4-битное число с плавающей точкой, и чего это стоит в обычных битах.

У 4-битного числа с плавающей точкой вроде E2M1 — элемента форматов NVFP4 и MXFP4 — 16 кодов, и два из них означают ноль. У трёх сбалансированных тритов 3 x 3 x 3 = 27 состояний. T27 — наш формат, который использует их все: 27 уровней стоят там, где на самом деле лежат веса обученной сети, и один общий масштаб на блок весов. На троичной памяти это больше уровней в том же объёме. Упакованный в обычные двоичные биты, он получается больше, а не меньше, и виджет показывает оба счёта.

Попробуйте

Проведите вес по всему диапазону и найдите, где E2M1 округляет хуже, чем T27; затем прочитайте таблицу хранения в битах. В спеке tnf8 тратит три трита на порядок числа: найдите тест, который считает его значения, и смещение, которое он резервирует.

+
T27 cell: 27 seats in 3 trits against FP4's 16 codes in 4 bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/tnf8.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Честная таблица результатов

+
+

Вы узнаетеКак T27 сравнивали с NVFP4, MX+ и MXFP4 на настоящей языковой модели и чего этот результат не показывает.

Формат судят по тому, что он делает с моделью. Мы сохранили веса одной небольшой языковой модели в каждом формате и измерили перплексию на тексте, которого она не видела: чем ниже, тем точнее модель. Правило записали до запуска: T27 побеждает соперника, если его перплексия ниже 990 тысячных от перплексии соперника. Он победил NVFP4, MX+ и MXFP4 и проиграл E2M2, более широкому формату. Под столбцами — список того, чего этот тест утверждать не может. Утверждение, которое выдерживает проверку, одно: T27 выигрывает у NVFP4 на троичной подложке.

Попробуйте

Найдите отношение для NVFP4 и линию порога; затем назовите формат, которому T27 проигрывает, и чем тот платит за это. Спека — контроль для другого утверждения: найдите, что, по её заголовку, опровергнет совпадение с posit, и тест, который держит es равным 2 на любой ширине.

+
T27 vs NVFP4: six weight formats on one small language modelВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/posit_ladder_control.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Таблицы модели на плате

+
+

Вы узнаетеКак компьютер кормит плату работой через последовательный мост, почему важен размер окна и что плата посчитала.

Арифметику делает плата; компьютер отправляет ей работу через последовательный USB-мост. Ответы платы ждут в маленьком приёмном буфере микросхемы моста, и если держать в полёте больше запросов, чем помещается их ответов, ответы теряются. Окно поменьше убрало потери и не замедлило прогон. По этой линии плата перемножила все троичные матрицы весов небольшой языковой модели, и каждая строка совпала с эталоном бит в бит. Сам текст генерирует Mac, который делает всё, кроме троичных скалярных произведений: плата — это калькулятор, а не вся модель.

Попробуйте

Тяните окно, пока ведро не переполнится, и запомните самое большое окно, которое помещается; затем сравните два настоящих прогона. В спеке weighted применяет вес только по знаку; найдите apply_alpha, где слой умножает один раз, и тест, который показывает, что он округляет вниз.

+
The bucket under the tap: a 512-byte UART buffer and 19-byte answersВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/igla/race/unit_weights_node.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · ИИ-числа: блок MX

Как ИИ-чипы хранят веса в нескольких битах: один общий масштаб на блок, сам байт масштаба и что один выброс делает с соседями.

+
+
04

Урок 4 из 27

Один масштаб на блок весов

+
+

Вы узнаетеПочему ИИ-форматы делят один масштаб на блок весов и как читается байт масштаба OCP MX.

У языковой модели миллионы весов, и хранить и пересылать полное число с плавающей точкой для каждого дорого. Форматы Microscaling (MX) консорциума Open Compute Project хранят каждый вес в 4, 6 или 8 битах и дают каждому блоку из 32 весов один общий масштаб. Этот масштаб — один байт, E8M0: без знака и без мантиссы, только порядок, так что код e означает 2 в степени e минус 127, а код 255 означает NaN. Плеер компилирует e8m0.t27, спеку этого байта, прямо в вашем браузере и запускает её тесты. Проверку, которую браузер выполнить не может, он пропускает и объясняет почему.

Попробуйте

Запустите тесты и посчитайте пропуски; затем откройте Verilog и найдите функцию, которая проверяет код 255. В спеке каталог даёт FP4 E2M1 и MXFP4 одинаковые биты: сравните их поля storage и найдите, что добавляет MXFP4.

+
e8m0.t27, the OCP MX scale byte, compiled inside the postВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/formats_catalog.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Байт масштаба на настоящей машине

+
+

Вы узнаетеЧто нативный компилятор проверяет в той же спеке, включая то, что браузер пропустил.

Плеер в прошлом уроке не смог выполнить все проверки в e8m0.t27 и прямо об этом сказал. Эта запись запускает нативный t27c и Zig на настоящей машине на той же спеке: её константы, отчёт о тестах, тесты Zig и Verilog для проверки на NaN. Часть проверок — инварианты, которые компилятор доказывает во время компиляции, так что компиляция и есть проверка. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите, сколько инвариантов отчёт доказал во время компиляции, и сравните число пройденных тестов с числом у плеера.

+
t27c on e8m0.t27 -- the MX shared scale byte, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/e8m0.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Один выброс, много нулей

+
+

Вы узнаетеЧего стоит общий масштаб: как один крупный вес обнуляет мелкие веса своего блока, формат за форматом.

Общий масштаб задаёт самое большое значение в блоке, поэтому один выброс задаёт его для всех 32 весов. Веса, намного меньшие выброса, падают ниже самого мелкого шага, который может показать элемент, и записываются нулём. Эта запись нативно запускает ocp_mx.t27, нашу спеку OCP MX v1.0, на блоке из 31 мелкого веса и одного выброса и считает, сколько весов обнуляет каждый формат элемента. Затем она подкладывает ошибку, одно изменённое смещение порядка, и падает ровно один тест: спека, которая несёт свои тесты, ловит собственные ошибки.

Попробуйте

Найдите, какой формат элемента обнуляет больше всего мелких весов, а какие два — ни одного; затем найдите тест, который ломает подложенная ошибка. У 4-битного элемента узкий диапазон: в спеке найдите max_value и min_positive у GF4 и два теста, которые их закрепляют.

+
t27c on ocp_mx.t27 -- OCP MX v1.0, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf4.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Тернарные веса

Веса, которые бывают только минус масштаб, ноль или плюс масштаб, пять правил, которые должен пройти тернарный алфавит, и прогон тестов, который ничего не проверил.

+
+
07

Урок 7 из 27

Веса минус фи, ноль и плюс фи

+
+

Вы узнаетеКак тернарный вес хранится в 2 битах, зачем нужен четвёртый код и чего спека не утверждает о фи.

Тернарные сети вроде BitNet хранят каждый вес как минус единицу, ноль или плюс единицу, умноженные на масштаб, так что умножение превращается в сложение, вычитание или ничего. gfternary.t27 фиксирует этот масштаб равным фи, примерно 1,618, и хранит три значения в 2 битах: 00 — ноль, 01 — плюс фи, 10 — минус фи. У двух битов есть четвёртый код, 11, и спека сворачивает его в ноль, а не оставляет неопределённым. Спека говорит и о том, чего не утверждает: что масштаб фи выигрывает у обычных целых тернарных весов — открытая гипотеза, и она называет измеренный разрыв, который её опроверг бы. Плеер компилирует спеку в вашем браузере; большинство проверок здесь выполнить нельзя, и каждый пропуск объясняет почему.

Попробуйте

Запустите тесты и прочитайте, почему пропущенные проверки пропущены; затем найдите код, который сворачивается в ноль, и строку, которая это делает. Золотое сечение может задавать и устройство формата: в спеке найдите golden_section и прочитайте, как gft4 делит 4 позиции между знаком, тритами и мантиссой.

+
gfternary.t27, phi-scaled ternary weights, compiled inside the postВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gft4.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Прогон, который ничего не проверил

+
+

Вы узнаетеЧто такое пустой проход, почему зелёный отчёт может его скрыть и как подложенная ошибка отличает настоящие проверки от пустых.

Нативный t27c запускает все 13 тестов gfternary.t27, и все 13 проходят. Тот же отчёт печатает строку, которой нет у большинства инструментов: 8 из 13 прошли, не выполнив ни одного assert во время работы. Пустой проход — не ложь, но и не доказательство. 5 инвариантов доказываются, пока спека компилируется, и один из них утверждает только true — это заглушка. Поэтому запись подкладывает ошибку: зарезервированный код 11 больше не сворачивается в ноль. Падает ровно один тест — тот, что написан для этого правила. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите строку о пустых проходах и тест, который ломает подложенная ошибка; затем откройте спеку и найдите инвариант, который утверждает только true.

+
t27c on gfternary.t27 -- phi-scaled ternary weights, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gfternary.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Пять правил для алфавита весов

+
+

Вы узнаетеКакие значения может принимать тернарный вес, как пять измеренных правил оставляют одну формулу и что из неё убирает шестое правило.

Спека golden_sieve.t27 задаёт тернарному весу пять измеренных правил и шестое, которое сужает то, что они оставляют. S1: число значений — степень тройки; S2: не больше двух тритов, так как третий не дал значимого выигрыша. S3: одна линия накопителя, поэтому отношение любых двух весов рационально: плюс и минус фи проходят как общий масштаб, а 1 и фи требуют двух линий. S4: не больше шести входных битов на нейрон — спека называет это компромиссом, а не законом; S5: никаких ячеек DSP48E1 и SRL16E, для которых openXC7 записывал неверный битстрим, хотя каждый инструмент говорил OK. Пять правил оставляют TNF(k, b) с 3 или 9 уровнями, а S6 убирает форму с 9 уровнями: на любой целочисленной лестнице старший вес перевешивает остальные вместе, и решает один вход. Браузер выполняет все 3 теста и все 8 инвариантов.

Попробуйте

Запустите тесты; затем поменяйте в исходнике MAX_TRITS на 3 и посмотрите, какие две проверки упадут. В спеке триты задают порядок числа, а не вес: найдите exp_values у tnf4 и тест, который говорит, какое смещение не конечно.

+
golden_sieve.t27, the ternary sieve, compiled inside the postВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/tnf4.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Тернарный формат Ternary Network Float

Правило, которое компилятор проверяет до запуска любого теста, и 17-битное число с плавающей точкой, порядок которого — четыре сбалансированных трита.

+
+
10

Урок 10 из 27

Заблокирован — не значит провален

+
+

Вы узнаетеПочему правило, проверяемое при компиляции, останавливает спеку до запуска любого теста и чем это отличается от упавшего теста.

В браузере MAX_TRITS, равный 3, уронил две проверки. Нативный t27c строже: 8 инвариантов golden_sieve.t27 доказываются во время компиляции, поэтому с третьим тритом спека не компилируется вовсе. Отчёт пишет BLOCKED и объясняет, что заблокированная спека так и не дала бинарника, а значит, у неё нет результатов тестов. Правило, проверяемое при компиляции, не может уйти в сборку сломанным. Затем запись подкладывает другую ошибку: правило против ячеек сдвиговых регистров теперь всегда отвечает «да», и падает ровно один тест — тот, что проверяет формулу. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите строку, которая объясняет, почему у заблокированной спеки нет результатов тестов, и тест, который ломает вторая ошибка.

+
t27c on golden_sieve.t27 -- the ternary sieve, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/golden_sieve.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Число, у которого порядок — четыре трита

+
+

Вы узнаетеКак TNF17e упаковывает знак, тернарный порядок и мантиссу в 17 бит и почему 17, а не 16.

Имя TNF носят две разные вещи. В решете TNF(k, b) — алфавит весов с 3 или 9 уровнями. TNF17e в tnf17.t27 — Ternary Network Float, который спека называет знаковым форматом накопителя: бит знака, 7-битное смещение и 9-битная мантисса, а значение равно (-1)^s x (1 + m/512) x 2^(offset - 40). Его триты стоят в порядке, а не в весах: смещение принимает 81 значение, ровно 3^4, так что порядок — это четыре сбалансированных трита, от -40 до +40. Четыре трита стоят 7 бит на двоичном чипе, поэтому ступень занимает 17 бит, а не 16; спека записывает, что её источник считал позиции, а трит — не бит. Браузер выполняет 20 из 44 проверок, в том числе все 10 инвариантов, и у каждого пропуска называет приведение типа, которое не смог вычислить.

Попробуйте

Прочитайте причину у одного пропущенного теста; затем найдите инвариант, который говорит, что четыре трита дают 81 значение. В спеке у tnf16 тоже четыре трита порядка и сумма 16: найдите width_rule и прочитайте, что считает это 16 — биты или позиции.

+
tnf17.t27, a 17-bit ternary-exponent float, compiled inside the postВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/tnf16.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Дважды сменить знак — получить число обратно

+
+

Вы узнаетеКак тест свойства ловит ошибку в один символ, которую пропускает единичный пример.

Браузер пропустил 24 проверки tnf17.t27; нативный t27c запускает все 34 теста, все проходят, и ни один не пустой. Смена знака переворачивает бит знака через XOR. Запись меняет XOR на OR — ошибка в один символ. Смена знака у положительного числа по-прежнему выглядит верно, поэтому тест, который меняет знак у единицы, всё ещё проходит. Но отрицательное число теперь остаётся отрицательным, и двойная смена знака больше не возвращает исходное число. Падает ровно один тест, negate_is_an_involution, — тот, что формулирует это свойство. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите, сколько проходов были пустыми; затем вернитесь к плееру прошлого урока, сами замените XOR на OR и посмотрите, поймает ли это и браузер.

+
t27c on tnf17.t27 -- a 17-bit ternary-exponent float, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/tnf17.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Арифметика чисел со знаком

Умножить два числа со знаком, сложить их, когда знаки разные, и сделать то и другое сразу в умножении с накоплением.

+
+
13

Урок 13 из 27

Знак — это один бит

+
+

Вы узнаетеКак умножение чисел со знаком ставит знак произведения и какой тест замечает, когда знак не ставится никогда.

Модули с 1 по 4 были о том, как хранить числа: ячейка T27, байт масштаба OCP MX, тернарные веса с масштабом фи и TNF; этот модуль заставляет их считать. gft_smul.t27 использует биты tnf17.t27: 1.0 — это 20480, а -1.0 — это 86016, те же биты плюс бит знака 65536. smul ставит знак, когда знаки входов различаются, а величину отдаёт magmul. Браузер пропускает все 3 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 3, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который делает знак всегда равным 0, и снова t27c test-report: падает ровно один тест, m2, который умножает 1.0 на -1.0. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке m1 и m3 и поймите, почему знак, который всегда равен 0, не может их сломать.

+
t27c on gft_smul.t27 -- a sign is one bit, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_smul.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Разные знаки — вычитание

+
+

Вы узнаетеКак сложение чисел со знаком превращается в вычитание, когда знаки разные, и что его 3 теста оставляют непроверенным.

sadd в gft_sadd.t27 складывает два числа одного знака через magadd. Когда знаки разные, она вычитает меньшую величину из большей через magsub, берёт знак большего и при точном сокращении возвращает 0. Браузер пропускает все 3 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 3, все проходят, ни один не пустой. Знаки смешивает только a2, 1.0 плюс -1.0, и они сокращаются: magsub сразу возвращает 0, потому что величины равны. Ни один тест не вычитает две разные величины, поэтому знак большего ни разу не решает результат. Запись запускает t27c test-report, затем однострочный sed, который складывает величины в той ветке, куда попадает a2, и снова t27c test-report: падает ровно один тест, a2. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и значение, которого ждёт a2; затем найдите в спеке bsign и проверьте, зависит ли от него хоть один из a1, a2 и a3.

+
t27c on gft_sadd.t27 -- opposite signs subtract, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_sadd.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Умножить, потом сложить

+
+

Вы узнаетеЧто умножение с накоплением делает с двумя произведениями со знаком и как его ломает замена из урока 12.

Нейрон суммирует произведения весов на входы, и on_comb в gft_signed_mac.t27 — такая сумма из двух слагаемых: smul(a1, b1) плюс smul(a2, b2). Здесь smul ставит знак через XOR и не проверяет ноль. Нативный t27c запускает 4 теста, и все проходят; один из них, zero_clause, ждёт, что 0 x 1 + 0 x 1 даст 512, то есть 2^-39, а не 0, и комментарий называет это задуманным поведением. Браузер пропускает свои тесты, потому что его исполнитель пока не знает assert_eq. Запись запускает t27c test-report, затем повторяет ошибку урока 12 однострочным sed, который меняет XOR на OR, и снова запускает t27c test-report. Падает ровно один тест, pp: (-1.0) x (-1.0) теперь выходит отрицательным, и сумма равна 0 вместо 2.0. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи тест, который ждёт 512, и тест, который ломает подложенная ошибка; затем сами замените в спеке XOR в smul на OR и посмотрите, поймает ли это браузер.

+
t27c on gft_signed_mac.t27 -- multiply, then add, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_signed_mac.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Части нейрона

ReLU с изломом в нуле, степень двойки для softmax и argmax, который называет ответ.

+
+
16

Урок 16 из 27

Излом в нуле

+
+

Вы узнаетеПочему ReLU нужен тест с отрицательным входом, прежде чем можно сказать, что у неё есть излом.

Нейрон пропускает свою сумму через функцию активации, и в gft_relu.t27 это relu(x) = max(0, x). on_comb возвращает 0 для нуля и для любого входа с битом знака, а иначе сам x. Заголовок говорит, что у ReLU точный градиент 0/1 и что 2-слойная сеть с ReLU решает XOR, а линейная модель GF-T этого не может. Браузер пропускает все 4 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который пропускает отрицательные входы, и relu становится тождеством, прямой линией, и снова t27c test-report. Падает ровно один тест, negz; больше ни у одного теста нет отрицательного входа. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и значение, которого ждёт negz; затем найдите в спеке комментарий на этой строке и проверьте, описывает ли он код после замены.

+
t27c on gft_relu.t27 -- a bend at zero, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_relu.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Два в степени x

+
+

Вы узнаетеКак exp2 делит x на целую часть и дробь и почему её тесты доходят только до целой части.

Заголовок gft_exp2.t27 называет exp2 недостающим кирпичиком для softmax на GF-T. on_comb делит x на целую часть k и дробь f: k задаёт смещение, k + 40, а pow2_frac превращает f в мантиссу. Заголовок обещает ошибку не больше 1 ULP, измеренную в прототипе, но все 4 теста подают целые входы, 0, 1.0, -1.0 и 2.0, поэтому f равна 0, и pow2_frac возвращает 0 при любых коэффициентах. Браузер пропускает все 4 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который теряет минус у k для отрицательного x, и снова t27c test-report: падает ровно один тест, em1: 2^-1 выходит как 2.0, а не 0.5. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и значение, которого ждёт em1; затем найдите в спеке pow2_frac и выясните, что она возвращает, когда f равна 0.

+
t27c on gft_exp2.t27 -- two to the x, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_exp2.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Выбрать наибольшее

+
+

Вы узнаетеКак argmax называет класс, сравнивая одни только биты, и какое правило решает ничью.

Классификатор в конце называет класс с наибольшей оценкой. gft_argmax4.t27 делает это без арифметики: gt ставит отрицательные ниже нуля, ноль ниже положительных, а затем сравнивает младшие 16 бит, растущие с величиной. По заголовку ничью выигрывает меньший индекс, сравнение строгое >. Браузер пропускает все 4 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который меняет > на >= для двух положительных оценок, и снова t27c test-report: падает ровно один тест, tie_low: четыре оценки 1.0 теперь выбирают индекс 3, а не 0. Ни один тест не даёт решить ответ двум отрицательным оценкам: переворот их сравнения ничего не роняет. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке строку, которая сравнивает две отрицательные оценки, и тот один тест, который до неё доходит.

+
t27c on gft_argmax4.t27 -- pick the largest, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_argmax4.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Обучение на ошибке

Потеря, которая оценивает неверную догадку в битах, один шаг, который сдвигает вес против градиента, и скрытый слой, который нужен XOR.

+
+
19

Урок 19 из 27

Потеря в битах

+
+

Вы узнаетеКак потеря -log2(p) оценивает догадку в битах и почему безошибочная догадка должна стоить ровно 0.

Обучение начинается с числа, которое говорит, насколько неверной была догадка. gft_nll.t27 берёт p, вероятность, которую модель дала верному классу, и возвращает -log2(p): p = 1.0 стоит 0, p = 0.5 стоит 1 бит, а p = 0.25 стоит 2. on_comb — это neg(log2v(p)), и neg переворачивает бит знака, но для 0 возвращает 0. Одна строка заголовка всё ещё говорит, что на выходе log2(x); код возвращает его с обратным знаком. Браузер пропускает все 3 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 3, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который заставляет neg возвращать 65536 для 0, ноль с поставленным битом знака, и снова t27c test-report: падает ровно один тест, perfect. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке строку заголовка, где сказано, что на выходе log2(x), и сравните её с on_comb.

+
t27c on gft_nll.t27 -- a loss in bits, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_nll.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Один шаг вниз по склону

+
+

Вы узнаетеКак один шаг SGD сдвигает вес против градиента и почему тест с двумя равными входами не может их различить.

gft_sgd_step.t27 сдвигает вес против градиента: w' = w - eta*g, где eta — скорость обучения. Её 3 теста: step, где w = 1.0, g = 0.5 и eta = 0.5; nograd, где g = 0 оставляет w как есть; и ascend, где g = -1.0 и eta = 1.0 поднимают w до 2.0. Браузер пропускает все 3 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 3, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который умножает g на само себя вместо eta, и снова t27c test-report. В step g равно eta, а в nograd оба произведения равны 0. Поэтому падает ровно один тест, ascend, где вес падает до 0, вместо того чтобы подняться до 2.0. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке step и решите, какой из его входов нужно изменить, чтобы он поймал ошибку.

+
t27c on gft_sgd_step.t27 -- one step downhill, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_sgd_step.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

XOR нужен излом

+
+

Вы узнаетеПочему сети нужен скрытый слой с ReLU, чтобы вычислить XOR, и что делает один пропавший излом.

XOR равен 1, когда ровно один вход равен 1, и комментарий в gft_xornet.t27 говорит, что одиночная линейная модель не может его разделить. on_comb — 2-слойная сеть: две скрытые суммы, z0 и z1, каждая через relu, затем взвешенная сумма h0 и h1. Она не обучается: тесты подают веса, заданные вручную, аналитическое решение W=[[1,1],[1,1]], c=[0,-1], v=[1,-2]. Браузер пропускает все 4 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который убирает relu только у h1, и снова t27c test-report: падает ровно один тест, x00: в (0,0) z1 равно -1.0, и выход становится 2.0 вместо 0. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем вычислите в спеке z1 для x10, x01 и x11 и поймите, почему relu там ничего не меняет.

+
t27c on gft_xornet.t27 -- XOR needs a bend, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_xornet.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · BitNet: тернарные сети

Порог, который сжимает сумму обратно до трёх значений, один нейрон, который становится другой функцией при смене весов, и нейрон, который читает входы по 27 тритов за раз.

+
+
22

Урок 22 из 27

Обратно в три значения

+
+

Вы узнаетеКак порог превращает сумму нейрона обратно в трит и почему каждому краю мёртвой зоны нужен свой тест.

Нейрон тернарной сети складывает произведения тритов, и сумма может быть любым небольшим целым. quantize в activation_quantizer.t27 сжимает её обратно: выше порога возвращает 2 (P), ниже минус порога — 0 (N), между ними — 1 (Z). on_comb в конце делает её комбинационной: регистра нет, выход следует за входами. Браузер пропускает все 7 тестов, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 7, все проходят, ни один не пустой. Запись меняет > на >= в строке 6, и сумма, равная порогу, уже считается P. Падает ровно один тест, quantize_boundary_hi, который ждёт Z от quantize(10, 10). Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке quantize_boundary_lo и определите, какую замену одного символа в строке 7 он поймает.

+
t27c on activation_quantizer.t27 -- Quantize at the edge, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/activation_quantizer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Тот же нейрон, другие веса

+
+

Вы узнаетеКак один тернарный нейрон считает голосование большинством с одними весами и другую функцию — с другими.

maj3 в bitnet_majority.t27 упаковывает три трита через pack3, берёт dot27 с w_all_p, куском весов из одних P, и квантует с порогом 0: результат — знак a + b + c. weighted_vote — тот же нейрон с весами pack3(2, 2, 0), и он даёт знак a + b - c: функцию выбирают веса. Браузер пропускает все 12 тестов, потому что пока не знает assert_eq; нативный t27c запускает все 12, все проходят, ни один не пустой. Запись уменьшает w_all_p на 16, и вес на дорожке 2 из P становится Z: maj3 больше не видит c. Падает ровно один тест, maj_p_n_n: +1 - 1 - 1 даёт N, а +1 - 1 даёт Z. Заметьте: wv_p_z_p передаёт средним входом 0, то есть N, а не Z. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи ожидаемое и полученное значение maj_p_n_n; затем найдите в спеке wv_p_z_p и вычислите, что вернёт weighted_vote(2, 1, 2).

+
t27c on bitnet_majority.t27 -- One neuron, two functions, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/bitnet_majority.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Нейрон по кускам

+
+

Вы узнаетеКак нейрон с числом входов больше 27 складывает скалярные произведения кусок за куском и почему важен тест без кусков.

Один упакованный кусок вмещает 27 тритов, поэтому широкому нейрону нужно несколько. neuronN в bitnet_neuron_nchunk.t27 принимает до 8 кусков активаций и весов, складывает dot27 для nchunks пар, начиная с куска 0, и квантует сумму. Браузер пропускает все 11 тестов, потому что пока не знает assert_eq; нативный t27c запускает все 11, все проходят, ни один не пустой. Запись меняет границу цикла в строке 36 с nchunks на 1, и нейрон всегда читает ровно один кусок. Остальные тесты нейрона заполняют все куски одинаково, и одного куска хватает, чтобы оказаться по ту же сторону порога. Падает ровно один тест, neuron_zero_chunks, который не даёт ни одного куска и ждёт Z. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи строку цикла до и после изменения; затем найдите в спеке neuron_two_chunks и объясните, почему та же ошибка его не ломает.

+
t27c on bitnet_neuron_nchunk.t27 -- A neuron over N chunks, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/bitnet_neuron_nchunk.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · Тернарный MAC как чип

Скалярное произведение 27 тритов как провода без регистра, та же сумма, которую регистр копит на каждом такте, и небольшая целая сеть в конце курса.

+
+
25

Урок 25 из 27

Скалярное произведение из проводов

+
+

Вы узнаетеВо что on_comb превращает спеку и как один неверный знак в tmul проявляется ровно в одном тесте.

on_comb в comb_ternary_dot.t27 комбинационный: сгенерированный Verilog подаёт result одним assign без регистра, и выход следует за входами. Он складывает tp по всем 27 дорожкам a и b, а tp вызывает tmul, который возвращает 0, если хоть один трит равен Z, +1 при совпадении и -1 иначе. Поэтому N на N даёт +1, и dot_all_n_x_all_n ждёт 27. Браузер пропускает все 4 теста, потому что пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись меняет return -1 на return 1 в строке 22, и падает ровно один тест, dot_all_n_x_all_p, — тот, где N стоит против P. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку tmul и упавший тест; затем найдите в спеке dot_all_n_x_all_n и объясните, почему он ждёт 27, а не -27.

+
t27c on comb_ternary_dot.t27 -- The dot product as wires, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/comb_ternary_dot.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Складывать на каждом такте

+
+

Вы узнаетеЧто on_clock добавляет к скалярному произведению и почему тесты этой спеки не доходят до регистра.

stream_ternary_mac.t27 берёт тот же dot27 и добавляет регистр acc и on_clock, который прибавляет dot27(a, b) к acc. on_clock тактируемый: он срабатывает раз на фронт такта, а acc хранит значение между фронтами. В сгенерированном Verilog низкий rst_n обнуляет acc, а acc меняется, только пока en высокий; в самой спеке en нет. Нативный t27c запускает все 4 теста, все проходят, ни один не пустой; браузер их пропускает: он не знает assert_eq. Все 4 вызывают dot27, ни один не запускает on_clock, так что строку накопления проверяет виджет test-waves, а не тест. Запись сужает маску для a в строке 26 с 3 до 1, и P в a читается как N: падает ровно один тест, dot_all_p_x_all_p. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую маску и упавший тест; затем найдите в спеке on_clock и убедитесь, что ни один тест его не вызывает.

+
t27c on stream_ternary_mac.t27 -- Accumulate on the clock, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/stream_ternary_mac.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Целая сеть

+
+

Вы узнаетеКак части этого курса складываются в одну небольшую сеть и что её тесты и её Verilog ещё оставляют открытым.

mlp2 в bitnet_mlp.t27 — целая сеть: 3 нейрона читают вход, pack3 упаковывает их 3 трита в скрытый кусок, и 2 нейрона превращают его в 2 выходных трита. Курс прошёл от форматов чисел и арифметики к нейрону, обучению, тернарным весам и чипу; здесь есть нейрон, веса и вход on_comb, а обучения нет. Нативный t27c запускает все 4 теста, все проходят, ни один не пустой; браузер их пропускает, и ни один не вызывает mlp2. Сгенерированный Verilog помечает цикл по кускам в neuronN как NOT UNROLLED, и его примечание говорит, что yosys такое отвергает, так что это ещё не чип. Запись переносит третий скрытый трит из бита 4 в бит 3 в строке 39, и падает ровно один тест, pack3_zzz. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи строку pack3 до и после изменения; затем откройте в спеке вкладку Code, выберите verilog и найдите в neuronN цикл с пометкой NOT UNROLLED.

+
t27c on bitnet_mlp.t27 -- A whole ternary network, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/bitnet_mlp.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Лаборатория: наши исследования
    1. 01 T27: наш собственный формат чисел
    2. 02 Честная таблица результатов
    3. 03 Таблицы модели на плате
  2. 02 · ИИ-числа: блок MX
    1. 04 Один масштаб на блок весов
    2. 05 Байт масштаба на настоящей машине
    3. 06 Один выброс, много нулей
  3. 03 · Тернарные веса
    1. 07 Веса минус фи, ноль и плюс фи
    2. 08 Прогон, который ничего не проверил
    3. 09 Пять правил для алфавита весов
  4. 04 · Тернарный формат Ternary Network Float
    1. 10 Заблокирован — не значит провален
    2. 11 Число, у которого порядок — четыре трита
    3. 12 Дважды сменить знак — получить число обратно
  5. 05 · Арифметика чисел со знаком
    1. 13 Знак — это один бит
    2. 14 Разные знаки — вычитание
    3. 15 Умножить, потом сложить
  6. 06 · Части нейрона
    1. 16 Излом в нуле
    2. 17 Два в степени x
    3. 18 Выбрать наибольшее
  7. 07 · Обучение на ошибке
    1. 19 Потеря в битах
    2. 20 Один шаг вниз по склону
    3. 21 XOR нужен излом
  8. 08 · BitNet: тернарные сети
    1. 22 Обратно в три значения
    2. 23 Тот же нейрон, другие веса
    3. 24 Нейрон по кускам
  9. 09 · Тернарный MAC как чип
    1. 25 Скалярное произведение из проводов
    2. 26 Складывать на каждом такте
    3. 27 Целая сеть
+ + + + + diff --git a/apps/website/public/ru/learn/ai-numbers/index.html b/apps/website/public/ru/learn/ai-numbers/index.html index ba9889bfbe..5d1fb7c3b8 100644 --- a/apps/website/public/ru/learn/ai-numbers/index.html +++ b/apps/website/public/ru/learn/ai-numbers/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

ИИ-числа на t27: от форматов чисел до тернарной сети

Он продолжает курс по FPGA с того места, где тот заканчивается. Каждый урок открывает настоящий инструмент или запись t27c и Zig на настоящей машине рядом со спекой, которую можно запустить в браузере.

Курс 2, 27 уроков, в каждом виджет и спека t27: наш собственный формат чисел, блочные форматы OCP MX, которыми пользуются ИИ-чипы, тернарные веса и Ternary Network Float, затем арифметика со знаком, части нейрона, шаг обучения, тернарные нейроны BitNet и тернарный MAC как логика. Каждый новый урок подкладывает одну ошибку и показывает тест, который её ловит.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/all/card.png b/apps/website/public/ru/learn/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..397ffbbff6a764ef72f7415875a6537eebb7e442 GIT binary patch literal 41102 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 S@%$O@{icQ%2Kei)&;A86#M$`( literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/all/index.html b/apps/website/public/ru/learn/all/index.html new file mode 100644 index 0000000000..9a14b96c3b --- /dev/null +++ b/apps/website/public/ru/learn/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Основы t27: язык за 27 уроков: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

Основы t27: язык за 27 уроков

+

Перед курсом по FPGA: что такое спека t27, как компилятор её читает и что отдаёт в ответ. Каждый урок открывает таблицу или схему из своей спеки и одну спеку, которую можно запустить в браузере.

+

Курс 0, 27 уроков, в каждом инфографика и спека t27: модуль, константы и типы, функции и тесты, затем стадии компилятора и 7 языков, которые он пишет. Идёт перед курсом по FPGA.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

Пройдено 0 из 27

+

Открыть интерактивный курс →

+
+

Модуль 1 · Файл спеки

Что лежит в файле .t27: строка module, строки прозы и комментарии.

+
+
01

Урок 1 из 27

Что такое спека

+
+

Вы узнаетеЧто входит в файл .t27 и что компилятор возвращает в ответ.

Спека — это обычный текстовый файл с окончанием .t27. Он начинается строкой module, объявляет значения и функции и несёт блоки test, которые их проверяют. Компилятор t27c читает файл и отвечает вердиктом и кодом для 7 бэкендов. В спеке этого урока 2 константы и 1 тест, и сайт компилирует её прямо в вашем браузере.

Попробуйте

Откройте спеку урока в плеере и найдите три её части: строку module, константы и тест.

+
t27 basics 1: the three parts of a specВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/01_what_a_spec_is.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Строка module

+
+

Вы узнаетеКак пишется строка module, какие имена она принимает и где стоит.

Строка module — это ключевое слово module, имя и точка с запятой. Перед ней могут стоять комментарии и строки прозы; объявления идут после. Имя состоит из букв, цифр и подчёркиваний; компилятор на этом сайте принимает и дефисы, как в tutorial-06-structs. Спека курса на этом сайте обязана носить имя модуля, которого ждёт её генератор, поэтому неверное имя ловит сборка, а не компилятор.

Попробуйте

В плеере поменяйте имя модуля в спеке урока и убедитесь, что вердикт остаётся чистым.

+
t27 basics 2: the module lineВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/02_the_module_line.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Комментарии и строки прозы

+
+

Вы узнаетеГде может стоять каждый вид заметки и какая строка ломает парсер.

Строка, которая начинается с точки с запятой, — это проза: компилятор пропускает её до конца. Строки прозы стоят на верхнем уровне, между объявлениями. Две косые черты начинают комментарий где угодно: после кода или внутри теста. Ловушка: точка с запятой одна на строке — это не пустая строка прозы, а ошибка разбора, и падает вся спека. Поставьте после неё слово или оставьте строку пустой.

Попробуйте

Добавьте в спеку урока в плеере строку с одной точкой с запятой, прочитайте ошибку и уберите её.

+
t27 basics 3: where comments may standВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/03_comments_and_prose.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Значения и типы

Константы, ширина целого числа, а также true, false и текст.

+
+
04

Урок 4 из 27

Константы

+
+

Вы узнаетеШесть частей объявления константы и что делает каждая.

pub const WIDTH : u8 = 8; читается слева направо: pub делает имя видимым другим модулям, const говорит, что значение неизменно, WIDTH — имя, u8 — тип, 8 — значение, точка с запятой завершает строку. Константы — то, что умеет проверять тестовый прогон этого сайта: спека урока объявляет WIDTH, HEIGHT и AREA и проверяет, что 8 на 4 даёт 32.

Попробуйте

Поменяйте AREA в спеке урока на 33 и посмотрите, какой тест упадёт.

+
t27 basics 4: a constant, piece by pieceВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/04_constants.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Целые числа и их ширина

+
+

Вы узнаетеЦелые типы, их диапазоны и ошибка для значения, которое не помещается в тип.

Буква u в имени типа означает беззнаковый, i — со знаком, а цифры — число битов. u8 хранит от 0 до 255, u16 — от 0 до 65535, i32 хранит и отрицательные числа. Компилятор сверяет константу с её типом: дайте u8 значение 300, и он остановится с ошибкой о том, что никакой u8 не вмещает 3 цифры. В других местах проверка в браузере снисходительна, так что её молчание — не доказательство.

Попробуйте

Поставьте BYTE_MAX равным 300 в плеере и прочитайте ошибку, которую напечатает компилятор.

+
t27 basics 5: integer widths and their rangesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/05_whole_numbers.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Истина, ложь и текст

+
+

Вы узнаетеКак объявить bool и str и с чем их может сравнить тест.

bool — это true или false. str — текст в двойных кавычках, и в нём могут стоять символы, которые в других местах t27 что-то значат, например точка с запятой или две косые: внутри кавычек это просто текст. Тест сравнивает bool и str через == и !=. Честное ограничение: проверка в этом браузере не останавливает строку, отданную константе u8, так что следите за типами сами.

Попробуйте

Поменяйте NAME в спеке урока и поправьте тест, чтобы он снова прошёл.

+
t27 basics 6: bool and strВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/06_true_false_and_text.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Массивы, триты и выражения

Списки значений, три значения трита и что вычисляют операторы.

+
+
07

Урок 7 из 27

Массивы

+
+

Вы узнаетеКак объявить массив, прочитать элемент и какой индекс последний.

Тип массива — это длина в квадратных скобках и тип элемента: [5]u8 — пять беззнаковых байтов. Значение перечисляет элементы в квадратных скобках. Индекс 0 — начальный элемент, поэтому в массиве из 5 последний индекс 4. Тест читает элемент так: PRIMES[4]. Следите, чтобы объявленная длина совпадала со списком: проверка в этом браузере не ловит расхождение.

Попробуйте

Добавьте в PRIMES шестое простое число, поправьте длину и напишите assert для индекса 5.

+
t27 basics 7: an array and its indexesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/07_arrays.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Триты: минус один, ноль, один

+
+

Вы узнаетеКак трит записывается маленькой знаковой константой и почему 27 встречается повсюду.

У бита два значения, у трита три: минус один, ноль и один. Спека урока записывает их константами i8 NEG, ZERO и POS, как это делают учебные спеки t27. POS плюс NEG даёт ZERO. У трёх тритов 3 на 3 на 3 сочетаний, то есть 27: столько уроков в этом курсе и клеток в слове TRI-27.

Попробуйте

Напишите assert, что POS минус NEG равно 2, и проверьте, что он проходит.

+
t27 basics 8: three values of a tritВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/08_trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Выражения

+
+

Вы узнаетеАрифметические операторы и сравнения на константах урока и bool, который возвращает сравнение.

Выражение соединяет имена и числа операторами. При A = 17 и B = 5 A + B равно 22, A - B равно 12, A * B равно 85, A / B равно 3, потому что целые делятся без дроби, а A % B равно 2, это остаток. Сравнения дают true или false. Ограничение тестового прогона на этом сайте: он не читает минус перед числом, поэтому отрицательные значения пишите константами.

Попробуйте

Поменяйте B на 4 и предскажите все пять результатов до запуска тестов.

+
t27 basics 9: operators on two numbersВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/09_expressions.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Тесты и функции

Блок test, несколько маленьких тестов в одной спеке и функция с типизированными входами.

+
+
10

Урок 10 из 27

Блок test

+
+

Вы узнаетеКак пишется блок test и что сообщает упавший assert.

Блок test начинается ключевым словом test и именем и держит в фигурных скобках строки assert. Каждый assert принимает выражение, которое обязано быть истинным. Когда одно ложно, отчёт называет тест и номер assert, например assert #1 is false. Тесты спеки — это её утверждения о себе самой, поэтому каждая спека курса на этом сайте их несёт.

Попробуйте

Нарочно сломайте тест, поменяв DAYS, и прочитайте строку отказа.

+
t27 basics 10: a test block, passing and failingВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/10_a_test_block.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Много тестов в одной спеке

+
+

Вы узнаетеПочему несколько маленьких тестов читаются проще одного длинного и как отчёт их считает.

Спека может держать сколько угодно блоков test. Каждый проверяет одну мысль и носит имя, которое её называет. Отчёт считает тесты и assert отдельно: в спеке урока 3 теста и 5 assert. Когда один падает, его имя говорит, какая мысль сломалась, а остальные тесты по-прежнему отчитываются о своих.

Попробуйте

Сделайте так, чтобы один из трёх тестов упал, и проверьте, что два других проходят.

+
t27 basics 11: three tests, one idea eachВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/11_many_tests.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Функции

+
+

Вы узнаетеДва способа записать сигнатуру функции в t27 и тело с return.

fn add(a: u8, b: u8) -> u8 объявляет функцию с двумя входами u8 и результатом u8; тело в фигурных скобках заканчивается return. Компилятор принимает и стиль Zig, pub fn add(a: u8, b: u8) u8, без стрелки. Обобщений нет: fn id<T> — ошибка разбора. Тестовый прогон этого сайта проверяет константы и не вызывает функции, поэтому урок держит ожидаемые результаты константами рядом с ними.

Попробуйте

Напишите в плеере функцию sub в любом из двух стилей и проверьте, что вердикт чистый.

+
t27 basics 12: a function signature, piece by pieceВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/12_functions.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Внутри функции

Имена через let и var, выбор через if и switch и циклы.

+
+
13

Урок 13 из 27

Локальные имена: let и var

+
+

Вы узнаетеКогда нужен let, а когда var и как обновляется var.

let a = w * h; даёт имя значению внутри тела функции. var i : u8 = 0; объявляет имя, которое может меняться, а i = i + 1; меняет его. let нужен, когда значение вычисляется один раз, var — когда его обновляет цикл. Эти имена живут только внутри функции; на уровне модуля используется const.

Попробуйте

Замените let на var в area и проверьте вердикт; потом объясните, почему там уместнее let.

+
t27 basics 13: let, var and constВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/13_local_names.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Выбор: if, else и switch

+
+

Вы узнаетеФормы if, которые принимает компилятор, выражение if и switch с else.

if (a > b) { ... } else { ... } выполняет один из двух блоков. Скобки необязательны: if a > b { ... } тоже компилируется. if бывает и выражением: return if (a > b) a else b; даёт большее из двух. switch (m) { 0 => 10, else => 20 } выбирает значение по совпадению m, а else покрывает все остальные случаи.

Попробуйте

Добавьте в switch в плеере случай 1 => 15 и проверьте вердикт.

+
t27 basics 14: the shapes of a choiceВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/14_if_and_else.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Циклы: while и for

+
+

Вы узнаетеТри формы цикла, которые принимает компилятор, и как пишется диапазон.

while (i < n) { i = i + 1; } повторяет блок, пока условие истинно, и блок обязан приближать момент, когда оно станет ложным. for i in 0..n { } проводит i от 0 до n, не включая само n. Компилятор принимает и форму Zig: for (0..4) |i| { }. Цикл обычно обновляет var, объявленную перед ним.

Попробуйте

Посчитайте вручную, что вернёт sum_to при n = 4, и запишите это константой с тестом.

+
t27 basics 15: three loop formsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/15_loops.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Видимость и свои типы

Что pub открывает другим модулям, и структуры и перечисления, которые вы объявляете.

+
+
16

Урок 16 из 27

pub или закрытое имя

+
+

Вы узнаетеЧто объявляет pub и что пишет бэкенд TypeScript с ним и без него.

pub перед const, fn, struct или enum говорит, что имя могут использовать другие модули. Без pub имя предназначено самому модулю. Сегодня компилятор не соблюдает это в коде, который пишет: gen-ts экспортирует и pub-константу, и закрытую константу спеки урока. Используйте pub, чтобы сказать, что модуль предлагает, и читайте сгенерированный код, прежде чем полагаться на закрытость.

Попробуйте

Откройте вкладку ts спеки урока в плеере и найдите обе константы.

+
t27 basics 16: what pub changes in the generated codeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/16_pub_or_private.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Структуры

+
+

Вы узнаетеКак объявить struct и packed struct и сколько их может быть в модуле.

pub struct Point { x: i32, y: i32 } объявляет тип с двумя полями. Поле — это имя и тип, поля разделяются запятыми. packed struct кладёт поля вплотную, без выравнивания, как устроен аппаратный регистр. В модуле может быть несколько структур; в спеке урока их две, и вердикт чист на всех 7 бэкендах.

Попробуйте

Добавьте в Point поле z: i32 и проверьте, какие бэкенды его по-прежнему компилируют.

+
t27 basics 17: a struct and its fieldsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/17_structs.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Перечисления

+
+

Вы узнаетеДва способа объявить enum и как switch читает значение.

pub enum Color { Red, Green, Blue } называет три случая. Форма Zig pub const Mode = enum(u8) { Idle, Run } ещё и задаёт тип, в котором хранится случай, здесь u8. switch по значению перечисляет, что даёт каждый случай, и закрывает остальное через else. Обе формы в спеке урока чисто компилируются на всех 7 бэкендах.

Попробуйте

Добавьте в Color четвёртый цвет и обновите CASES_IN_COLOR, чтобы тест прошёл.

+
t27 basics 18: two ways to write an enumВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/18_enums.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Модули, правила и gen-ts

Чтение другого модуля, правило, которое выполняется всегда, и спека, превращённая в TypeScript.

+
+
19

Урок 19 из 27

Другие модули

+
+

Вы узнаетеКак пишется строка use и что браузер может и чего не может с ней сделать.

use base::types; называет модуль по пути, части разделены ::. Парсер читает это как объявление use. У компилятора в вашем браузере нет копии других файлов, поэтому он не открывает base::types и не проверяет имена, которые оттуда приходят. Нативный t27c разрешает импорты из репозитория; этот урок не мог выполнить такую проверку здесь.

Попробуйте

Найдите объявление use в дереве разбора спеки урока в плеере.

+
t27 basics 19: what a use line does in the browserВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/19_use_other_modules.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Инварианты и замеры

+
+

Вы узнаетеКак пишутся блоки invariant и bench и кто их вычисляет.

invariant с именем и следующим assert задаёт правило спеки, которое верно для любого значения, а не для одного примера. bench с именем отмечает блок для замера времени. Оба компилируются. Тестовый прогон этого сайта вычисляет только блоки test: инварианты и замеры он пропускает, так что ложный инвариант здесь проходит молча. Поэтому спека урока повторяет свой инвариант тестом.

Попробуйте

Сделайте инвариант ложным в плеере и убедитесь, что этот сайт молчит, затем сделайте ложным тест.

+
t27 basics 20: test, invariant and benchВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/20_invariants.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

gen-ts: спека превращается в TypeScript

+
+

Вы узнаетеЧто gen-ts пишет для констант и функций и как это использует программа-хозяин.

t27c gen-ts превращает каждую константу в строку export const, которую проверяет TypeScript. Функции не выводятся: бэкенд говорит, что переносит объявления, а не тела. Так этот сайт и пользуется спеками: генератор читает файл .t27 и пишет числа и слова, которые импортирует страница. Таблица под уроком показывает, что gen-ts написал для спеки урока.

Попробуйте

Добавьте константу в спеку урока в плеере и найдите её строку во вкладке ts.

+
t27 basics 21: what gen-ts writesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/21_gen_ts.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Компилятор и tri

Бэкенды, которые пишет t27c, стадии, в которых он читает спеку, и команда tri.

+
+
22

Урок 22 из 27

Семь бэкендов

+
+

Вы узнаетеИмена 7 бэкендов и сколько кода каждый написал для одной маленькой спеки.

У компилятора в вашем браузере 7 бэкендов: c, js, rust, ts, verilog, verilog_hir и zig. Каждый читает одну и ту же разобранную спеку и пишет код на своём языке; бэкенд verilog_hir пишется из аппаратного представления, HIR. Таблица показывает, сколько байтов написал каждый бэкенд для спеки урока, по замеру компилятором этого сайта. Больше не значит выше качеством: каждому языку нужно разное количество текста.

Попробуйте

Откройте в плеере каждую вкладку бэкенда спеки урока и найдите функцию add.

+
t27 basics 22: one spec, seven backendsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/22_seven_backends.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Стадии t27c

+
+

Вы узнаетеПорядок стадий компилятора и что каждая выдала для спеки урока.

Лексер режет текст на токены. Парсер строит дерево узлов. Проверка типов сообщает об ошибках и предупреждениях, не останавливая бэкенды. HIR — аппаратное представление, из которого пишется бэкенд verilog_hir; остальные бэкенды читают дерево парсера. Таблица показывает, что выдала каждая стадия для спеки урока, по замеру компилятором этого сайта.

Попробуйте

Откройте виджет стадий t27c, вставьте спеку урока и сверьте числа с таблицей.

+
t27 basics 23: the stages of t27c, countedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/23_stages_of_t27c.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

tri: командная строка

+
+

Вы узнаетеЧто делает tri test, как tri передаёт остальные слова t27c и какие команды у него свои.

В репозитории gHashTag/t27 scripts/tri — небольшая обёртка. tri test запускает набор проверок соответствия, t27c suite --repo-root .; слово, которого tri не знает, например gen или seal, передаётся t27c. Свои команды у него — audit, recall, frontier, lesson и help. Этот урок прочитал скрипт и не запускал его: нативный t27c собирается на машине с Linux, и этот курс не запускает его на вашей.

Попробуйте

Прочитайте таблицу и скажите, какие команды уходят в t27c, а какие остаются внутри tri.

+
t27 basics 24: where a tri command goesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/24_tri_commands.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · Ошибки, программа и что дальше

Как читать ошибку компилятора, одна маленькая законченная программа и какой курс пройти дальше.

+
+
25

Урок 25 из 27

Как читать ошибки компилятора

+
+

Вы узнаетеКак читать строку и столбец ошибки на четырёх настоящих промахах.

Ошибка разбора говорит, где был парсер, около какой строки и какой токен он не ждал, с номером строки и столбца. Ошибка типов называет константу и почему её значение не помещается. Сначала прочитайте позицию, потом посмотрите на токен левее: промах часто стоит прямо перед местом, где парсер остановился. Таблица показывает, что ответил компилятор этого сайта на четыре маленьких промаха.

Попробуйте

Повторите в плеере каждый из четырёх промахов и сверьте строку и столбец с таблицей.

+
t27 basics 25: four mistakes and what t27c saysВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/25_reading_errors.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Маленькая законченная программа

+
+

Вы узнаетеКак части этого курса складываются в одну спеку, которая становится схемой.

В спеке урока есть строка module, константа ширины, тестовые значения и on_comb — функция двух входов u8. gen-verilog превращает её в модуль, у которого порты — такт, сброс и разрешение, два 8-битных входа a и b, выход ready и 8-битный выход result. Строка assign задаёт result из on_comb, так что сама сумма не ждёт фронта такта. Тесты проверяют примеры сумм как константы; прогон на сайте не вызывает on_comb, так что проверка самой схемы остаётся симулятору.

Попробуйте

Откройте вкладку verilog спеки урока в плеере и найдите строки input, output и assign.

+
t27 basics 26: an adder in t27 and its Verilog portsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/26_a_small_program.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Куда дальше

+
+

Вы узнаетеКакой курс пройти дальше и что каждый добавляет к основам.

Теперь вы умеете читать спеку: строку module, константы, типы, функции, тесты и код, который пишут её бэкенды. Курс 1 ведёт спеку на FPGA Artix-7: синтез, размещение, тайминги и битстрим, проверенный на плате. Курс 2 строит на t27 форматы чисел для ИИ, от блоков OCP MX до тернарной сети. В обоих курсах по 27 уроков, и каждый урок открывает спеку.

Попробуйте

Выберите следующий курс по таблице и откройте его урок 1.

+
t27 basics 27: three courses, in orderВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/basics/27_where_next.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Файл спеки
    1. 01 Что такое спека
    2. 02 Строка module
    3. 03 Комментарии и строки прозы
  2. 02 · Значения и типы
    1. 04 Константы
    2. 05 Целые числа и их ширина
    3. 06 Истина, ложь и текст
  3. 03 · Массивы, триты и выражения
    1. 07 Массивы
    2. 08 Триты: минус один, ноль, один
    3. 09 Выражения
  4. 04 · Тесты и функции
    1. 10 Блок test
    2. 11 Много тестов в одной спеке
    3. 12 Функции
  5. 05 · Внутри функции
    1. 13 Локальные имена: let и var
    2. 14 Выбор: if, else и switch
    3. 15 Циклы: while и for
  6. 06 · Видимость и свои типы
    1. 16 pub или закрытое имя
    2. 17 Структуры
    3. 18 Перечисления
  7. 07 · Модули, правила и gen-ts
    1. 19 Другие модули
    2. 20 Инварианты и замеры
    3. 21 gen-ts: спека превращается в TypeScript
  8. 08 · Компилятор и tri
    1. 22 Семь бэкендов
    2. 23 Стадии t27c
    3. 24 tri: командная строка
  9. 09 · Ошибки, программа и что дальше
    1. 25 Как читать ошибки компилятора
    2. 26 Маленькая законченная программа
    3. 27 Куда дальше
+ + + + + diff --git a/apps/website/public/ru/learn/an-encoder-block/index.html b/apps/website/public/ru/learn/an-encoder-block/index.html index 390ea67d9b..bf1a129144 100644 --- a/apps/website/public/ru/learn/an-encoder-block/index.html +++ b/apps/website/public/ru/learn/an-encoder-block/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Блок энкодера

Вы узнаете

Что один блок энкодера трансформера делает со своим входом и что меняет перенос нормализаций вперёд.

Слой трансформера это два подслоя, каждый обёрнут остаточным сложением и нормализацией слоя: самовнимание смешивает позиции, затем сеть прямого распространения ширины 8 работает с каждой позицией отдельно. В порядке post-norm из исходной статьи блок кончается нормализацией, поэтому у каждой строки выхода среднее 0 и дисперсия 1.000. Pre-norm ставит нормализации перед каждым подслоем и кончается остаточным сложением, поэтому его строки выходят с дисперсиями 2.73, 3.33 и 0.96; глубокие стопки так учатся легче, с одной нормализацией в самом верху. Спека encoder_block.t27 прогоняет один блок на 3 позициях, d_model 4 и 2 головах.

Попробовать

Переключайтесь между post-norm и pre-norm и читайте дисперсии строк; затем найдите позицию, которую голова 1 читает больше всего.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

An encoder block: what one transformer layer does
An encoder block: what one transformer layer does ↗

Three positions through one transformer block: attention, a residual, a feed-forward net and layer norm. Post-norm ends every row at mean 0 and variance 1; pre-norm does not.

specs/ml/transformer/encoder_block.t27

// SPDX-License-Identifier: Apache-2.0
@@ -439,6 +471,7 @@ 

Блок энкодера

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/an-honest-scoreboard/index.html b/apps/website/public/ru/learn/an-honest-scoreboard/index.html index 409ca925e9..a31bf45357 100644 --- a/apps/website/public/ru/learn/an-honest-scoreboard/index.html +++ b/apps/website/public/ru/learn/an-honest-scoreboard/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Честная таблица результатов

Вы узнаете

Как T27 сравнивали с NVFP4, MX+ и MXFP4 на настоящей языковой модели и чего этот результат не показывает.

Формат судят по тому, что он делает с моделью. Мы сохранили веса одной небольшой языковой модели в каждом формате и измерили перплексию на тексте, которого она не видела: чем ниже, тем точнее модель. Правило записали до запуска: T27 побеждает соперника, если его перплексия ниже 990 тысячных от перплексии соперника. Он победил NVFP4, MX+ и MXFP4 и проиграл E2M2, более широкому формату. Под столбцами — список того, чего этот тест утверждать не может. Утверждение, которое выдерживает проверку, одно: T27 выигрывает у NVFP4 на троичной подложке.

Попробуйте

Найдите отношение для NVFP4 и линию порога; затем назовите формат, которому T27 проигрывает, и чем тот платит за это. Спека — контроль для другого утверждения: найдите, что, по её заголовку, опровергнет совпадение с posit, и тест, который держит es равным 2 на любой ширине.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

T27 vs NVFP4: six weight formats on one small language model
T27 vs NVFP4: six weight formats on one small language model ↗

Perplexity of six weight formats on SmolLM2-135M and the pre-registered ladder: T27 better than NVFP4, MX+ and MXFP4 on a trit substrate, worse than E2M2. Every limit listed.

specs/numeric/posit_ladder_control.t27

// SPDX-License-Identifier: Apache-2.0
@@ -208,6 +240,7 @@ 

Честная таблица результатов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/anatomy-of-a-tb/index.html b/apps/website/public/ru/learn/anatomy-of-a-tb/index.html index 2bb6a424fd..7058cecc12 100644 --- a/apps/website/public/ru/learn/anatomy-of-a-tb/index.html +++ b/apps/website/public/ru/learn/anatomy-of-a-tb/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Анатомия тестбенча

Вы научитесь

Из чего состоит каждый *_tb.t27: стимулы, ожидания, проверки, вердикт.

Каждый тестбенч в этом репозитории — один .t27-файл с одним и тем же скелетом, и плеер компилирует его как любой другой spec. Откройте fifo_tb: он строит стимулы (байты в FIFO), ожидания (те же байты по порядку), проверки (по одному ассерту на инвариант, чтобы провал называл именно нарушенный) и вердикт (счёт, а не ощущение). Виджет генерирует JavaScript из spec прямо в браузере и запускает его — та же связка «сгенерировать и исполнить», на которой стоит тестбенч, причём достаточно маленькая, чтобы увидеть её целиком.

Попробуйте

Сгенерируйте JavaScript для spec fifo_tb в плеере и запустите его; найдите ассерт, который упал бы раньше остальных, если бы FIFO терял байт.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

hello_world.t27 to JavaScript, in a terminal inside the post
hello_world.t27 to JavaScript, in a terminal inside the post ↗

A terminal in your browser running the t27 compiler as WebAssembly: t27c gen js prints the JavaScript it emits for hello_world.t27, and t27c test runs the spec's tests.

specs/fpga/testbench/fifo_tb.t27

// FIFO testbench spec
@@ -302,6 +334,7 @@ 

Анатомия тестбенча

}

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/angle-and-magnitude/index.html b/apps/website/public/ru/learn/angle-and-magnitude/index.html index 791966af08..4d6639a37d 100644 --- a/apps/website/public/ru/learn/angle-and-magnitude/index.html +++ b/apps/website/public/ru/learn/angle-and-magnitude/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Угол и модуль

Вы узнаете

Как режим векторизации CORDIC даёт atan2 и длину вектора без делителя.

Режим векторизации рулит в другую сторону: он опускает вектор на ось x и накапливает угол, на который повернул. То, что осталось на оси x, — длина, растянутая в 1/K(n), примерно 1.6467602581 раза, поэтому одно умножение на K(n) даёт модуль. Вектор в левой полуплоскости сначала поворачивается на 90 градусов. Для (3, 4) 16 шагов дают длину 5.000000 и угол 53.13 градуса. Спека cordic.t27 вычисляет шаги и эталоны.

Попробовать

Перетащите точку в каждую четверть и сравните угол с ожидаемым; затем задайте 8 шагов и прочитайте, насколько y далёк от 0.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

CORDIC vectoring: angle and length without a divide
CORDIC vectoring: angle and length without a divide ↗

Drag a point and watch CORDIC turn its vector down onto the x axis, step by step, reading off atan2 and the magnitude with shifts and adds.

specs/fpga/dsp/cordic.t27

// SPDX-License-Identifier: Apache-2.0
@@ -437,6 +469,7 @@ 

Угол и модуль

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/arithmetic-and-dsp/all/card.png b/apps/website/public/ru/learn/arithmetic-and-dsp/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..f0c0179b0e2df59e04c924d9476e4c6ab03bd579 GIT binary patch literal 48131 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 VRLUf#b)T6uZ4G_(GSz3{{|gf%X>|Yq literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/arithmetic-and-dsp/all/index.html b/apps/website/public/ru/learn/arithmetic-and-dsp/all/index.html new file mode 100644 index 0000000000..0a30754abe --- /dev/null +++ b/apps/website/public/ru/learn/arithmetic-and-dsp/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Арифметика и DSP на FPGA: от цепи переноса до фильтра: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

Арифметика и DSP на FPGA: от цепи переноса до фильтра

+

Он продолжает курс о шинах. Каждый виджет в нём исполняет тела fn спеки t27, скомпилированные в WebAssembly: двигаете ползунок — отвечает спека.

+

Курс 9, 27 уроков, в каждом живой виджет и спека t27: сумматоры и цепи переноса, умножители и слайс DSP48E1, фиксированная точка, CORDIC, дискретизация, фильтры FIR и CIC, БПФ и фильтр на стенде. Каждое число считает скомпилированная спека.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

0 из 27 пройдено

+

Открыть интерактивный курс →

+
+

Модуль 1 · Сложение

Почему сложение медленное: перенос, который идёт вверх по слову, выделенная цепь в каждом слайсе, префиксные сети и деревья сохранения переноса.

+
+
01

Урок 1 из 27

Цепь переноса

+
+

Вы узнаетеПочему перенос проходит всё слово и как выделенная цепь слайса делает этот путь дешёвым.

Бит i суммы a + b — это XOR битов a_i, b_i и входящего в него переноса, а выходной перенос — их мажоритарная функция. Перенос, рождённый в бите 0 суммы 127 + 1, должен пройти биты с 1 по 6, прежде чем старший бит узнает свой ответ: виджет подсвечивает эту серию из 7. Перенос, пересчитанный в LUT, стоит LUT и трассу на каждый бит; выделенная цепь слайса серии 7 стоит одну LUT и одну трассу, а затем один шаг на бит, блоками CARRY4 по 4 бита. Спека adders.t27 задаёт обе модели и оставляет три задержки вам.

Попробовать

Загрузите 127 + 1 и найдите самую длинную серию переносов; затем переключитесь на 85 + 170 и объясните, почему серия равна 0. Поставьте шаг 30 пс и сравните две задержки для 32 бит.

+
The carry chain: why adding is slow, and how a slice makes it fastВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/adders.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Взгляд вперёд: префиксные сумматоры

+
+

Вы узнаетеКак префиксная сеть вычисляет все переносы за log2 n уровней и чем за это платят Kogge-Stone, Sklansky и Brent-Kung.

Переносы сумматора — это префиксы одного ассоциативного оператора, поэтому их можно считать деревом, а не цепью. Виджет рисует четыре сети по функции src() спеки, по точке на каждую префиксную ячейку. На 16 битах ripple нужно 15 уровней; Kogge-Stone — 4 уровня и 49 ячеек, Brent-Kung — 7 уровней и 26 ячеек, Sklansky — 4 уровня и 32 ячейки при коэффициенте разветвления 8. Спека не принимает эти числа на веру: covers() прогоняет каждую сеть на отрезках и проверяет, что каждый столбец в итоге покрывает биты от 0 до i.

Попробовать

На 16 битах нажмите на бит 15 в каждой сети и сосчитайте белые точки; затем назовите сеть с наименьшим числом уровней и сеть с наименьшим числом ячеек.

+
Prefix adders: trade logic levels for cells and wiresВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/adders.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Три числа сразу

+
+

Вы узнаетеКак счётчики 3:2 складывают много чисел почти без распространения переноса и сколько слоёв нужно для k чисел.

Счётчик 3:2 — это ряд полных сумматоров без связей между ними: на входе три числа, на выходе слово суммы и слово переноса, и эти два в сумме дают те три. Слои таких счётчиков сжимают k чисел до двух, а затем их доскладывает один обычный сумматор. Высоты Дадды 2, 3, 4, 6, 9, 13, 19, 28, 42, 63 — наибольшее число слагаемых, которое сводит каждое количество слоёв, поэтому 9 числам нужно 4 слоя, а 64 — 10. Для 9 чисел по 16 бит это 20 задержек полного сумматора против 128 у цепочки сумматоров.

Попробовать

Задайте 28 чисел, а затем 29: сколько слоёв нужно каждому и почему одно лишнее число стоит слоя? Затем проверьте в счётчике ниже, что сумма + перенос равны a + b + c.

+
Carry-save adders: add many numbers with almost no carriesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/adders.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Умножение

Произведение — сумма сдвинутых копий; перекодирование Бута вдвое сокращает их, а слайс DSP48E1 делает остальное одним блоком.

+
+
04

Урок 4 из 27

Сдвиг и сложение

+
+

Вы узнаетеПочему умножитель — это стопка сдвинутых частичных произведений и сколько их стоит число.

Каждый бит множителя, равный 1, добавляет копию множимого, сдвинутую на позицию этого бита; каждый бит 0 не добавляет ничего. 200 x 13 — это 200 + 800 + 1600 = 2600, три строки из восьми. Два 8-битных числа дают не больше чем 16-битное произведение, а матричный умножитель — ровно эта сетка вентилей AND, питающая деревья сохранения переноса из прошлого урока. Спека multipliers.t27 вычисляет каждую строку и текущую сумму, которые рисует виджет.

Попробовать

Пройдите 200 x 13 строка за строкой; затем найдите множитель b от 0 до 255, при котором складываются все восемь строк, и такой, при котором складывается одна.

+
Shift and add: a multiplier is a pile of shifted copiesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/multipliers.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Приём Бута

+
+

Вы узнаетеКак перекодирование Бута по основанию 4 превращает восемь строк в четыре и обрабатывает знаковые числа без особого случая.

Читайте множитель по три бита, с перекрытием в один, с неявным 0 ниже бита 0. Каждая группа становится цифрой от -2 до +2, а каждая цифра — одним частичным произведением: цифра x a x 4^k. Для 3 x 6 цифры числа 6 равны -2, +2, 0, 0, и произведение равно -6 + 24 = 18. Именно отрицательные цифры заставляют дополнительный код работать без шага коррекции. Спека сверяет перекодирование с a x b для каждой пары 8-битных чисел, всех 65536.

Попробовать

Загрузите -128 x -128 и прочитайте цифры; затем сравните строки Бута, которые складываются, со строками сдвига и сложения для b = 127.

+
Booth's trick: half the partial products, signs for freeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/multipliers.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Слайс DSP48E1

+
+

Вы узнаетеКак произведение раскладывается на умножители 25 x 18 и сколько слагаемых может просуммировать 48-битный аккумулятор.

Слайс DSP48E1 умножает 25-битное число на 18-битное в дополнительном коде в 48-битный аккумулятор, и у XC7A200T их 740. Произведению 25 x 18 нужно 43 бита, поэтому у аккумулятора остаётся 5 бит запаса: 32 слагаемых суммируются безопасно, а 33-е может переполнить. Более широкое произведение режется на куски, младшие на бит короче порта, потому что они беззнаковые: 32 x 32 занимает 4 слайса. Спека multipliers.t27 держит раскладку, защитные биты и запас.

Попробовать

Найдите самое широкое b, которое ещё помещается в один слайс рядом с 25-битным a; затем задайте 16 x 16 и найдите наибольшее число слагаемых, которое держит аккумулятор.

+
The DSP48E1 slice: fit a x b and its running sumВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/multipliers.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Фиксированная точка

Где стоит двоичная точка, что округление делает со значением и с его средним и что даёт каждый бит квантователя.

+
+
07

Урок 7 из 27

Форматы Q

+
+

Вы узнаетеКак читать и записывать слово Qm.n с фиксированной точкой: его диапазон, шаг и биты вокруг двоичной точки.

В Qm.n m целых бит вместе со знаком и n дробных; слово означает своё целое значение, умноженное на 2^-n. Q1.15 — 16-битное слово от -1 до 0.99997 с шагом 2^-15. У 0.7 нет точного слова Q1.15: ближайшее — 22938, оно стоит 0.70001. Старший бит весит минус свою позицию — в этом и весь дополнительный код. Спека fixed_point.t27 вычисляет диапазон, шаг, каждый бит и слово, к которому округляется значение.

Попробовать

Запишите 0.7 в Q1.15 и прочитайте ошибку; затем переключитесь на Q2.2 и перечислите все значения, которые держит формат.

+
Q formats: read and write a fixed-point numberВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/fixed_point.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Округление и насыщение

+
+

Вы узнаетеЧто усечение, округление и конвергентное округление делают со значением и с его средним и когда заворачивать, а когда насыщать.

Отбросить младшие биты — значит усечь, а усечение смещено: на линейном нарастании его средняя ошибка равна -0.25 LSB для одного отброшенного бита и стремится к -0.5, когда их больше. Округление половины вверх смещено в другую сторону, +0.25 для одного бита; конвергентное округление отправляет ничьи к чётному соседу и в среднем даёт 0. За пределами диапазона сумматор в дополнительном коде заворачивает бесплатно, превращая 1.0 в -1.0 в Q1.15; насыщение стоит компаратора и сохраняет знак. Спека fixed_point.t27 измеряет все три режима на нарастании.

Попробовать

Запишите 1.25 в Q3.1 каждым режимом округления и отметьте сохранённое значение; затем отбросьте 4 бита и прочитайте три смещения.

+
Rounding and saturation: the error you choose, and its biasВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/fixed_point.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Шум квантования

+
+

Вы узнаетеПочему каждый бит квантователя даёт около 6 дБ и где формула из учебника слишком оптимистична.

Ошибка квантователя — пила высотой в один шаг, и её мощность равна квадрату шага, делённому на 12. Для синуса полной шкалы это даёт 6.02 N + 1.76 дБ, около 74.0 дБ на 12 битах. Спека signals.t27 ещё и измеряет это: она квантует настоящий синус на 4096 отсчётах, в которых 127 периодов, и делит мощности. На 12 битах они совпадают; на 1 бите формула обещает 7.78 дБ, а измерение находит 6.44, потому что столь грубая ошибка не равномерна.

Попробовать

Пройдите от 1 до 4 бит и посмотрите, как сходится разрыв между формулой и измерением; затем прочитайте, что добавляет 16-й бит.

+
Quantization noise: each bit buys about 6 dBВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Функции в железе

Синус, косинус, угол и длина из сдвигов и сложений — и когда таблица оказывается выгоднее.

+
+
10

Урок 10 из 27

Поворот сдвигами

+
+

Вы узнаетеКак режим вращения CORDIC получает cos и sin одними сдвигами и сложениями.

На шаге i поворачивайте вектор на atan(2^-i) в ту или другую сторону: умножение на tan — это сдвиг на i, так что каждый шаг — два сдвига и два сложения. Выбор направления по знаку оставшегося угла сводит этот угол к нулю, а старт с K(n) вместо 1 компенсирует растяжение, которое добавляет каждый шаг; K(n) стремится к 0.6072529350. После 16 шагов 30 градусов дают cos 0.866018 и sin 0.500013. Спека cordic.t27 вычисляет каждый шаг, который рисует виджет.

Попробовать

Прогоните 30 градусов за 4 шага, а затем за 16, и прочитайте ошибки; затем найдите шаг, на котором направление впервые меняется на поворот по часовой стрелке.

+
CORDIC: rotate a vector with shifts and addsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/cordic.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Угол и модуль

+
+

Вы узнаетеКак режим векторизации CORDIC даёт atan2 и длину вектора без делителя.

Режим векторизации рулит в другую сторону: он опускает вектор на ось x и накапливает угол, на который повернул. То, что осталось на оси x, — длина, растянутая в 1/K(n), примерно 1.6467602581 раза, поэтому одно умножение на K(n) даёт модуль. Вектор в левой полуплоскости сначала поворачивается на 90 градусов. Для (3, 4) 16 шагов дают длину 5.000000 и угол 53.13 градуса. Спека cordic.t27 вычисляет шаги и эталоны.

Попробовать

Перетащите точку в каждую четверть и сравните угол с ожидаемым; затем задайте 8 шагов и прочитайте, насколько y далёк от 0.

+
CORDIC vectoring: angle and length without a divideВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/cordic.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Таблицы и интерполяция

+
+

Вы узнаетеСколько записей нужно таблице синуса и когда линейная интерполяция выгоднее лишних записей.

Таблица четверти волны из n записей отвечает с точностью около половины шага между ними; интерполяция между двумя записями снижает это до h^2/8, где h — это pi/2, делённое на n. При 16 записях по 16 бит ближайшая запись ошибается до 0.049, а интерполированный ответ — до 0.0012. Начиная с какого-то места, новые записи ничего не дают, потому что сами b-битные слова ошибаются до 1/(2S). Спека cordic.t27 строит таблицу и меряет её своим же CORDIC на 50 шагов.

Попробовать

Сравните 16 записей с интерполяцией и без; затем задайте 256 записей и найдите ширину слова, при которой ошибку ограничивают слова, а не записи.

+
Sine tables: entries, word width, and interpolationВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/cordic.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Сигналы и дискретизация

Что дискретизация делает с частотой, как генератор строится из сумматора и что измеряет бин ДПФ.

+
+
13

Урок 13 из 27

Дискретизация и наложение спектров

+
+

Вы узнаетеПочему тон выше половины частоты дискретизации возвращается более низким и в какую сторону он отражается.

Дискретизатор видит тон на f как тон на |f - fs round(f/fs)|: спектр складывается, как бумага, на каждом кратном fs/2. При частоте 100 тон на 70 виден на 30, как и тон на 130. В каждой второй зоне Найквиста складка идёт в обратную сторону, и псевдочастота выходит зеркальной. Временной вид показывает, почему ничто после дискретизатора не отличит их: отсчёты тона 70 лежат точно на тоне 30. Спека signals.t27 вычисляет складку, зону и каждую нарисованную точку.

Попробовать

Найдите три входные частоты, которые попадают на 30 при частоте 100; затем двигайте fs и смотрите, как смещаются углы треугольника.

+
Sampling and aliasing: the fold of every frequencyВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Генератор с числовым управлением

+
+

Вы узнаетеКак фазовый аккумулятор и таблица синуса дают любую частоту и насколько мелки её шаги.

Прибавляйте слово настройки M к N-битному аккумулятору каждый такт, и его старшие биты обегают круг с частотой f_out = M f_clk / 2^N. На 100 МГц при N = 32 слово M = 2^30 даёт 25 МГц, четверть оборота за такт, а соседняя частота отстоит на 0.0233 Гц. Старшие P бит фазы адресуют таблицу синуса; эмпирическое правило ставит наихудший паразит от усечения фазы примерно на 6.02 дБ на каждый оставленный бит ниже несущей. Спека signals.t27 выбирает M и вычисляет каждый отсчёт.

Попробовать

Попросите 1 МГц и прочитайте слово настройки и частоту, которую получаете на самом деле; затем урежьте таблицу до 4 бит фазы и посмотрите на выходные отсчёты.

+
The NCO: a phase accumulator and a sine tableВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Бины спектра

+
+

Вы узнаетеЧто измеряет один бин ДПФ и почему тон между бинами растекается по всем.

У ДПФ на L точек L бинов, каждый шириной fs/L. Тон, укладывающийся в окно целым числом периодов, попадает в один бин на 0 дБ и больше никуда. Сдвиньте его на полбина, и пик упадёт до -3.7 дБ и растечётся по всем бинам, потому что ДПФ считает окно одним периодом повторения, а повторение скачет на стыке. Окно Ханна сглаживает стык: при 8.5 бина на 64 точках оно опускает бин 20 с -33.2 дБ до -73.9 дБ. Спека signals.t27 вычисляет каждый бин.

Попробовать

Проведите тон от 8 до 9 бинов и следите за самым высоким бином; затем включите окно Ханна и сравните дальний бин.

+
Bins of a spectrum: one tone, and where it leaksВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Фильтры FIR

Скользящее среднее, расчёт окном sinc с целыми коэффициентами и раскладка отводов по слайсам DSP.

+
+
16

Урок 16 из 27

Скользящее среднее

+
+

Вы узнаетеПочему усреднение L отсчётов — фильтр нижних частот и где лежат его нули.

Усредните последние L отсчётов, и тон на f выйдет умноженным на |sin(pi f L) / (L sin(pi f))|. Для L = 4 это 1 на постоянном токе, 0.65328 на 1/8 частоты дискретизации и ровно 0 на 1/4: каждое кратное 1/L — нуль. Ему не нужен ни один умножитель, поэтому за него на FPGA берутся рано. Спека signals.t27 вычисляет характеристику и выход отсчёт за отсчётом.

Попробовать

Поставьте тон в нуль L = 4 и посмотрите, как выход исчезает; затем удвойте L и найдите новый нуль.

+
The moving average: a low-pass you can do in your headВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Расчёт коэффициентов

+
+

Вы узнаетеКак рассчитывается ФНЧ окном sinc и чего стоит округление его коэффициентов до целых.

Идеальный ФНЧ — это sinc; обрежьте его до конечного числа отводов и умножьте на окно, и появится полоса задерживания. При 31 отводе и срезе 0.1 без окна полоса задерживания от 0.2 остаётся на -32.8 дБ; окно Хэмминга опускает её до -62.6 дБ, а Блэкмана — до -76.1 дБ. Затем коэффициенты становятся целыми: на 16 битах полоса задерживания Хэмминга почти не двигается, на 8 битах поднимается обратно до -32.8 дБ. Спека signals.t27 рассчитывает коэффициенты и вычисляет обе характеристики.

Попробовать

Переключайте три окна при 31 отводе; затем уменьшайте биты коэффициентов, пока полосу задерживания не начнут задавать биты, а не окно.

+
Designing FIR taps: a window, a cutoff, and the bits you keepВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Раскладка отводов по слайсам

+
+

Вы узнаетеКак симметрия и быстрый такт сокращают число слайсов DSP, нужных фильтру FIR.

У FIR с линейной фазой коэффициенты симметричны, поэтому предсумматор DSP48E1 может сложить два отсчёта с общим коэффициентом и умножить один раз: 31 отводу нужно 16 умножителей. Слайс, тактируемый C раз за отсчёт, может выполнить C из них один за другим, поэтому на 50 МГц при такте 200 МГц работу делают 4 слайса, а на 48 кГц всё делает один слайс. У XC7A200T 740 слайсов. Спека signals.t27 назначает каждый отвод его слайсу.

Попробовать

Сравните 31 отвод на 50 МГц с симметрией и без неё; затем поднимайте частоту дискретизации, пока каждый слайс не станет обслуживать один умножитель.

+
Folding a FIR onto DSP slicesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Многоскоростная обработка

Понижение частоты дискретизации без заворота шума: децимация, фильтр CIC и полифазная форма.

+
+
19

Урок 19 из 27

Понижение частоты

+
+

Вы узнаетеЧто сохранение каждого R-го отсчёта делает со спектром и какие частоты заворачиваются в оставляемую полосу.

Оставьте каждый R-й отсчёт, и частота упадёт до fs/R, а каждая частота около кратного новой частоты окажется около 0. Проредите 400 в 4 раза, и тон на 95 попадёт на 5, прямо в полосу шириной 10. Виджет закрашивает каждую входную частоту, которая завернётся в полосу: именно это должен убрать фильтр перед дециматором, и поэтому там, где ничего не заворачивается, этот фильтр может быть дешёвым. Спека signals.t27 вычисляет каждый заворот.

Попробовать

При R = 4 и полосе 10 найдите красные зоны и поставьте тон в каждую; затем увеличьте R и посмотрите, как зон становится больше.

+
Decimation: lower the rate without folding noise inВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Фильтр CIC

+
+

Вы узнаетеКак дециматор CIC фильтрует без умножителей и на сколько бит должны вырасти его регистры.

Дециматор CIC — это N интеграторов на входной частоте, понижение частоты в R раз и N гребенчатых звеньев с задержкой M на выходной частоте. Его усиление на постоянном токе равно (RM)^N, поэтому регистры вырастают на ceil(N log2(RM)) бит: при N = 4, R = 8 и M = 1 это 4096 и 12 бит, 16-битный вход в 28-битных регистрах. Его характеристика имеет нуль на каждом кратном выходной частоты и проседает на 3.6 дБ на четверти её. Спека signals.t27 вычисляет усиление, рост и характеристику.

Попробовать

Задайте одно звено и сравните характеристику со скользящим средним; затем загрузите последний пресет и сосчитайте биты регистров.

+
The CIC filter: no multipliers, many bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

Полифазная форма

+
+

Вы узнаетеКак полифазная форма выполняет фильтрацию дециматора на низкой частоте.

Фильтровать на входной частоте и выбрасывать R - 1 из каждых R выходов — значит тратить впустую R - 1 из каждых R умножений. Раздайте вместо этого отводы по R фазам по правилу k mod R: каждая фаза — короткий фильтр, который встречает только каждый R-й вход, поэтому все они работают на выходной частоте. Фильтр на 31 отвод с децимацией в 4 раза падает со 124 MAC на выходной отсчёт до 31. Спека signals.t27 вычисляет фазы и счётчики.

Попробовать

Найдите число отводов, которое делится на 4 фазы поровну, и такое, которое не делится; затем сравните MAC при R = 8.

+
Polyphase: do the work at the low rateВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · БПФ

N log N вместо N^2: бабочки, бит-реверсный порядок входа и биты, которые добавляет каждый этап.

+
+
22

Урок 22 из 27

Бабочка

+
+

Вы узнаетеКак БПФ по основанию 2 разбивает ДПФ на этапы бабочек и что это экономит.

Бабочка берёт a и b, умножает b на поворачивающий множитель W и выдаёт a + Wb и a - Wb. БПФ по основанию 2 на N точек — это log2 N этапов по N/2 бабочек: 3 этапа по 4 бабочки на 8 точках, 5120 бабочек на 1024 точках против 1048576 умножений у прямого ДПФ. Виджет исполняет целочисленное БПФ спеки и показывает каждое значение: один период косинуса на 8 точках выходит как 509 в бинах 1 и 7. Спека signals.t27 вычисляет каждую бабочку.

Попробовать

По очереди подсветите каждый этап 8-точечного БПФ и сосчитайте поворачивающие множители, которые он использует; затем найдите этап, на котором значение входа DC удваивается.

+
The FFT butterfly: N log N instead of N^2Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Поворачивающие множители и бит-реверс

+
+

Вы узнаетеПочему БПФ с прореживанием по времени берёт вход в бит-реверсном порядке и откуда берутся поворачивающие множители.

Разбейте вход на чётные и нечётные отсчёты, затем разбейте каждую половину снова, и порядок, в котором вы в итоге их читаете, — индекс с битами в обратном порядке. На 8 точках индекс 1 — это 001, и он уходит на место 4, а 3 — это 011, и он уходит на место 6. Двойное обращение возвращает индекс, поэтому перестановка — набор обменов, которому не нужна арифметика, только проводка. Поворачивающие множители W — точки единичной окружности, cos минус j sin. Спека signals.t27 вычисляет и то и другое.

Попробовать

На 16 точках найдите все индексы, которые остаются на месте; затем выберите индекс и прочитайте его поворачивающий множитель.

+
Bit reversal: the order an FFT reads its input inВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Рост через этапы

+
+

Вы узнаетеНа сколько бит растут слова БПФ и что удерживает и чего лишает деление пополам на каждом этапе.

Каждый этап по основанию 2 может удвоить значение, поэтому БПФ без масштабирования вырастает до log2 N бит, а консервативная ширина ядра БПФ от AMD равна B + log2 N + 1. Вход DC полной шкалы показывает это наглядно: 12 бит на входе, 16 бит на выходе 16-точечного БПФ против 17 по правилу. Деление пополам на каждом этапе удерживает слово на 12 битах, но размазанный сигнал теряет бит точности на каждом этапе. Спека signals.t27 исполняет целочисленное БПФ, которое измеряет виджет.

Попробовать

Прогоните DC без масштабирования и с делением; затем прогоните шумовой вход обоими способами и сравните наибольший выход.

+
FFT word growth: how many bits each stage addsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · На стенде

От арифметики к плате: коррелятор из спеки модема, бюджет слайсов и тайминга и итоговый фильтр.

+
+
25

Урок 25 из 27

Коррелятор находит кадр

+
+

Вы узнаетеКак коррелятор Баркера-13 находит начало кадра и сколько перевёрнутых чипов он выдерживает.

Кадр начинается с 13 чипов кода Баркера, корреляция которого с собой равна 13 при совпадении и не больше 1 при сдвиге. Спека модема bpsk.t27 вталкивает каждый принятый чип в окно из 13 чипов и коррелирует его; захват происходит на 9, с запасом между боковым лепестком и пиком. Виджет исполняет эти самые функции на потоке из 32 чипов: пик стоит на 13 там, где совпадает преамбула, перевёрнутая несущая даёт -13, а каждый перевёрнутый чип в окне снижает пик на 2.

Попробовать

Переверните два чипа преамбулы и проверьте, что захват остаётся; затем найдите, сколько переворотов срывают захват.

+
A correlator finds the frame: Barker-13 in a stream of chipsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/bpsk.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Помещается ли и сходится ли тайминг?

+
+

Вы узнаетеКак составить бюджет слайсов DSP для многоканального фильтра и почему тайминг срывает дерево сумматоров, а не умножитель.

Шестнадцать каналов симметричного фильтра на 63 отвода на 50 МГц при такте 250 МГц занимают по 7 слайсов, 112 из 740 у XC7A200T. Сойдётся ли тайминг — вопрос об одном пути от регистра к регистру: прямое дерево сумматоров ставит в него ceil(log2 63) = 6 сумматоров, систолическая цепь через каскад слайсов — один. При заданных вами задержках дерево не укладывается в период 4000 пс, а цепь укладывается. Спека signals.t27 считает; отчёт о тайминге вашей сборки измеряет.

Попробовать

Загрузите пресет с деревом сумматоров, переключите его на систолическую цепь и прочитайте запас; затем найдите, сколько каналов фильтра на 127 отводов помещается.

+
Does it fit, and does it close timing?Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Итог: фильтр на плате

+
+

Вы узнаетеКак арифметика курса сходится в одном фильтре, посчитанном бит в бит так, как считает плата.

Рассчитайте ФНЧ из урока 17, подайте на него тон из полосы пропускания и тон из полосы задерживания 16-битными отсчётами и исполните его так, как это делает RTL: целые коэффициенты, широкий аккумулятор, округление половины вверх, насыщение до 16 бит. С 31 коэффициентом Хэмминга по 16 бит тон из полосы задерживания исчезает, аккумулятору нужно 32 бита, глубоко внутри 48 у DSP48E1, а выход остаётся в пределах 1.5 LSB от того же фильтра в f64. Чтобы поставить его на плату, кнопки ниже открывают квитанцию сборки и путь JTAG.

Попробовать

Уменьшите биты коэффициентов до 8 и посмотрите на столбики ошибки; затем перенесите тон из полосы задерживания в полосу пропускания и объясните выход.

+
Capstone: a filter as the board computes itВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dsp/signals.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Сложение
    1. 01 Цепь переноса
    2. 02 Взгляд вперёд: префиксные сумматоры
    3. 03 Три числа сразу
  2. 02 · Умножение
    1. 04 Сдвиг и сложение
    2. 05 Приём Бута
    3. 06 Слайс DSP48E1
  3. 03 · Фиксированная точка
    1. 07 Форматы Q
    2. 08 Округление и насыщение
    3. 09 Шум квантования
  4. 04 · Функции в железе
    1. 10 Поворот сдвигами
    2. 11 Угол и модуль
    3. 12 Таблицы и интерполяция
  5. 05 · Сигналы и дискретизация
    1. 13 Дискретизация и наложение спектров
    2. 14 Генератор с числовым управлением
    3. 15 Бины спектра
  6. 06 · Фильтры FIR
    1. 16 Скользящее среднее
    2. 17 Расчёт коэффициентов
    3. 18 Раскладка отводов по слайсам
  7. 07 · Многоскоростная обработка
    1. 19 Понижение частоты
    2. 20 Фильтр CIC
    3. 21 Полифазная форма
  8. 08 · БПФ
    1. 22 Бабочка
    2. 23 Поворачивающие множители и бит-реверс
    3. 24 Рост через этапы
  9. 09 · На стенде
    1. 25 Коррелятор находит кадр
    2. 26 Помещается ли и сходится ли тайминг?
    3. 27 Итог: фильтр на плате
+ + + + + diff --git a/apps/website/public/ru/learn/arithmetic-and-dsp/index.html b/apps/website/public/ru/learn/arithmetic-and-dsp/index.html index bb6ac26a68..fe66a80394 100644 --- a/apps/website/public/ru/learn/arithmetic-and-dsp/index.html +++ b/apps/website/public/ru/learn/arithmetic-and-dsp/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

Арифметика и DSP на FPGA: от цепи переноса до фильтра

Он продолжает курс о шинах. Каждый виджет в нём исполняет тела fn спеки t27, скомпилированные в WebAssembly: двигаете ползунок — отвечает спека.

Курс 9, 27 уроков, в каждом живой виджет и спека t27: сумматоры и цепи переноса, умножители и слайс DSP48E1, фиксированная точка, CORDIC, дискретизация, фильтры FIR и CIC, БПФ и фильтр на стенде. Каждое число считает скомпилированная спека.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/arrays/index.html b/apps/website/public/ru/learn/arrays/index.html index 75d45a4c17..3906aab008 100644 --- a/apps/website/public/ru/learn/arrays/index.html +++ b/apps/website/public/ru/learn/arrays/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Массивы

Вы узнаете

Как объявить массив, прочитать элемент и какой индекс последний.

Тип массива — это длина в квадратных скобках и тип элемента: [5]u8 — пять беззнаковых байтов. Значение перечисляет элементы в квадратных скобках. Индекс 0 — начальный элемент, поэтому в массиве из 5 последний индекс 4. Тест читает элемент так: PRIMES[4]. Следите, чтобы объявленная длина совпадала со списком: проверка в этом браузере не ловит расхождение.

Попробуйте

Добавьте в PRIMES шестое простое число, поправьте длину и напишите assert для индекса 5.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 7: an array and its indexes
t27 basics 7: an array and its indexes ↗

A t27 array drawn as a row of cells with their indexes, from the lesson spec. Lesson 7 of the t27 basics course.

specs/basics/07_arrays.t27

// SPDX-License-Identifier: Apache-2.0
@@ -82,6 +114,7 @@ 

Массивы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/assertions/index.html b/apps/website/public/ru/learn/assertions/index.html index 1a8b517ca6..1c62f0ea5e 100644 --- a/apps/website/public/ru/learn/assertions/index.html +++ b/apps/website/public/ru/learn/assertions/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Ассерты

Вы научитесь

Что такое ассерт в коде и сколько стоит проверять его каждый такт.

Ассерт — это проверка, которая остаётся в дизайне, каждый такт, навсегда: не тестбенч, исполняющийся однажды, а утверждение о железе, обязанное выполняться, пока железо работает. Spec урока, formal, записывает их как данные — немедленные и параллельные, серьёзность, названные такт и сброс, — потому что ассерт, который нельзя перечислить, нельзя и погасить. Виджет — та же идея на пороге: каждая зависимость, нужная инструменту, присутствует или нет, проверяется одним вызовом до всякого запуска.

Попробуйте

Запишите один немедленный и один параллельный ассерт для FIFO с названными тактом и сбросом; затем посмотрите в виджете зависимостей, что сам tri предполагает имеющимся.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri selftest: the dependencies tri needs
tri selftest: the dependencies tri needs ↗

tri, railway, python3 and the loop directory: each present or not, in one call.

specs/fpga/formal.t27

// SPDX-License-Identifier: Apache-2.0
@@ -422,6 +454,7 @@ 

Ассерты

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/attention/index.html b/apps/website/public/ru/learn/attention/index.html index 9de3eed72f..3b97346ca6 100644 --- a/apps/website/public/ru/learn/attention/index.html +++ b/apps/website/public/ru/learn/attention/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Внимание

Вы узнаете

Как внимание сравнивает каждый запрос с каждым ключом, что даёт softmax по каждой строке и что убирает причинная маска.

Внимание позволяет каждой позиции решить, какие другие позиции читать. Каждый запрос сравнивается с каждым ключом, q . k / sqrt(d), и softmax превращает каждую строку оценок в веса с суммой 1; выход это значения, усреднённые этими весами. Две головы делают это на двух половинах вектора. С причинной маской позиция не может читать будущее: в голове 0 позиция 0 читает только себя, позиция 1 делит 0.452 и 0.548, а позиция 2 распределяет 0.230, 0.321 и 0.449. Без маски каждая строка распределяется по всем трём ключам, от 0.21 до 0.47. Спека attention_mechanism.t27 вычисляет каждый вес на своей фикстуре.

Попробовать

Выключите и включите маску и прочитайте строку 0; затем сравните две головы в строке 2.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Attention: how a word decides which other words to read
Attention: how a word decides which other words to read ↗

Two heads of attention over three positions: each row is how much one query reads each key. Switch on the causal mask and a position can no longer read the future.

specs/ml/recurrent/attention_mechanism.t27

// SPDX-License-Identifier: Apache-2.0
@@ -375,6 +407,7 @@ 

Внимание

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/back-off/index.html b/apps/website/public/ru/learn/back-off/index.html index 1afcc100c7..b56c023089 100644 --- a/apps/website/public/ru/learn/back-off/index.html +++ b/apps/website/public/ru/learn/back-off/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Отступить

Вы узнаете

Почему строку, которая отвечает wait, проверяют всё реже и как часто хотя бы.

За 44 минуты на 2026-10-09 ревьюер сделал 941 визит к строкам, из них 888 с ответом wait, от 22 строк, чью ветку он не мог прочитать; одну строку проверили 54 раза. Теперь revisit_after_seconds ждёт 30 с после одного wait и удваивает паузу на каждый следующий, не больше 900 с: 30, 60, 120, 240, 480, 900. due_again даёт взять строку, только когда это время прошло, а любой другой ответ сбрасывает счёт.

Попробовать

Найдите число ожиданий, после которого пауза перестаёт расти; затем поставьте 4 ожидания и найдите секунду, когда строка снова к сроку.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Back off: when the reviewer looks at a waiting row again
Back off: when the reviewer looks at a waiting row again ↗

A row that answered wait is not visited again at once: 30 s, doubled per wait, never more than 900 s. Drag the waits and the clock and see when it is due.

specs/queen/reviewer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -383,6 +415,7 @@ 

Отступить

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/back-to-three-values/index.html b/apps/website/public/ru/learn/back-to-three-values/index.html index 7a61531a02..d99b33a817 100644 --- a/apps/website/public/ru/learn/back-to-three-values/index.html +++ b/apps/website/public/ru/learn/back-to-three-values/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Обратно в три значения

Вы узнаете

Как порог превращает сумму нейрона обратно в трит и почему каждому краю мёртвой зоны нужен свой тест.

Нейрон тернарной сети складывает произведения тритов, и сумма может быть любым небольшим целым. quantize в activation_quantizer.t27 сжимает её обратно: выше порога возвращает 2 (P), ниже минус порога — 0 (N), между ними — 1 (Z). on_comb в конце делает её комбинационной: регистра нет, выход следует за входами. Браузер пропускает все 7 тестов, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 7, все проходят, ни один не пустой. Запись меняет > на >= в строке 6, и сумма, равная порогу, уже считается P. Падает ровно один тест, quantize_boundary_hi, который ждёт Z от quantize(10, 10). Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке quantize_boundary_lo и определите, какую замену одного символа в строке 7 он поймает.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on activation_quantizer.t27 -- Quantize at the edge, native
t27c on activation_quantizer.t27 -- Quantize at the edge, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 7 tests pass natively; one > in the quantizer becoming >= fails exactly one test, quantize_boundary_hi; git restores the spec.

specs/ternary/activation_quantizer.t27

module ActivationQuantizer;
@@ -101,6 +133,7 @@ 

Обратно в три значения

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/backpropagation/index.html b/apps/website/public/ru/learn/backpropagation/index.html index 075e842007..b3c5bcca79 100644 --- a/apps/website/public/ru/learn/backpropagation/index.html +++ b/apps/website/public/ru/learn/backpropagation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Обратное распространение

Вы узнаете

Как градиент каждого веса и каждого входа слоя следует из градиента его выходов.

Чтобы учиться, каждому весу нужно знать, как меняется потеря, когда он сдвигается. Обратное распространение отвечает по одному слою за раз: при данном g, насколько потеря хочет сдвинуть каждый выход, вес от входа i к выходу o получает g_o x_i, а вход i получает сумму по o от W[o][i] g_o и передаёт её слою ниже. При входах (1, 2, 3) и g = (1, 0.5) градиенты весов равны 1, 2, 3 и 0.5, 1, 1.5, а градиенты входов 0.5, 2 и 3.5. Слой линейный, поэтому сдвиг x0 на 1 сдвигает потерю g . y с 15.25 до 15.75, на его градиент 0.5. Спека dense_layer.t27 вычисляет все три.

Попробовать

Поставьте g = (1, 0) и посмотрите, какие рёбра гаснут; затем поставьте g = (-2, 1) и проверьте градиенты входов вручную.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Backpropagation: how blame flows back through a layer
Backpropagation: how blame flows back through a layer ↗

Set how much the loss wants each of two outputs to move: every weight gets that times its input, every input gets W transposed times it. The edges and nodes show the numbers.

specs/ml/layers/dense_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -282,6 +314,7 @@ 

Обратное распространение

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/balanced-ternary/index.html b/apps/website/public/ru/learn/balanced-ternary/index.html index db6fa05603..39efc503df 100644 --- a/apps/website/public/ru/learn/balanced-ternary/index.html +++ b/apps/website/public/ru/learn/balanced-ternary/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сбалансированная троичная

Вы узнаете

Как цифры -1, 0 и +1 записывают любое целое, отрицательные тоже, без знака.

В сбалансированной троичной системе веса разрядов 1, 3, 9, 27, а каждая цифра равна -1, 0 или +1. Тогда 8 — это 9 - 1, а -8 — это -9 + 1: знак живёт в самих цифрах. Шесть тритов покрывают числа от -364 до +364, и у каждого числа ровно одна запись. Плитки под счётчиком — это trit_at() спеки, вызванная по разу на разряд; один из её тестов восстанавливает каждое число от -400 до 400 из его тритов.

Попробовать

Посчитайте от -13 до 13 и следите, какая плитка меняется; найдите число, на котором появляется четвёртый трит.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Balanced ternary: count with -1, 0 and +1
Balanced ternary: count with -1, 0 and +1 ↗

Step a number up and down and watch its trits change. Every integer, negative ones too, has one form with no sign symbol.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Сбалансированная троичная

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/batch-normalisation/index.html b/apps/website/public/ru/learn/batch-normalisation/index.html index 9bcc022e3c..6cffd980b8 100644 --- a/apps/website/public/ru/learn/batch-normalisation/index.html +++ b/apps/website/public/ru/learn/batch-normalisation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Пакетная нормализация

Вы узнаете

Как пакетная нормализация приводит признаки разного масштаба к одному и чем она пользуется при выводе.

Признаки разного масштаба дёргают сеть: в пакете спеки один признак в десять раз больше другого. Пакетная нормализация вычитает среднее каждого признака по пакету и делит на его разброс, поэтому признаки 1, 2, 3, 4 и 10, 20, 30, 40 оба выходят как -1.34, -0.45, 0.45 и 1.34, а -1, -1, 1, 1 выходит как -1 и 1. Затем выученные gamma и beta масштабируют и сдвигают его обратно, где это полезно. При выводе слой вместо пакета использует скользящие средние: при среднем 0, дисперсии 1, gamma 1 и beta 0.25 входы 1, 2 и 3 дают 1.25, 2.25 и 3.25. Спека batchnorm_layer.t27 вычисляет оба режима.

Попробовать

Сравните два нормализованных столбца; затем поставьте скользящее среднее 2 и дисперсию 4 и прочитайте выходы вывода.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Batch norm: features on very different scales, made comparable
Batch norm: features on very different scales, made comparable ↗

A batch of 4 samples whose 3 features live on scales 1, 10 and 1: batch norm gives each feature mean 0 and variance 1. Then set gamma and the running statistics for inference.

specs/ml/layers/batchnorm_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -273,6 +305,7 @@ 

Пакетная нормализация

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/baud-and-the-divisor/index.html b/apps/website/public/ru/learn/baud-and-the-divisor/index.html index 9a976acd66..68fef275de 100644 --- a/apps/website/public/ru/learn/baud-and-the-divisor/index.html +++ b/apps/website/public/ru/learn/baud-and-the-divisor/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Бод и делитель

Вы узнаете

Как один делитель превращает такт в скорость битов и что ломает его смену.

Скорость — это делитель: такт, поделённый на бод, даёт период бита, и спека заявляет его константным выражением — UART_BIT_PERIOD равно UART_CLOCK_HZ / UART_BAUD_RATE, 100,000,000 на 115,200. Тест uart_configure_changes_baud_divisor проверяет, что конфигурация драйвера сдвигает делитель. Запись показывает спеку, опущенную в аппаратный IR: собственный взгляд компилятора на провода и состояние до того, как существует Verilog.

Попробовать

В записи проследите IR-вид делителя; затем в спеке найдите UART_BIT_PERIOD и тест, который его двигает.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c debug-hir on uart.t27 -- the bus as the compiler sees it
t27c debug-hir on uart.t27 -- the bus as the compiler sees it ↗

The UART spec lowered to hardware IR: the compiler's own view of the wires, ports and state before Verilog exists.

specs/fpga/uart.t27

// SPDX-License-Identifier: Apache-2.0
@@ -297,6 +329,7 @@ 

Бод и делитель

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/bins-of-a-spectrum/index.html b/apps/website/public/ru/learn/bins-of-a-spectrum/index.html index 34bae7b3b8..e18d58b465 100644 --- a/apps/website/public/ru/learn/bins-of-a-spectrum/index.html +++ b/apps/website/public/ru/learn/bins-of-a-spectrum/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Бины спектра

Вы узнаете

Что измеряет один бин ДПФ и почему тон между бинами растекается по всем.

У ДПФ на L точек L бинов, каждый шириной fs/L. Тон, укладывающийся в окно целым числом периодов, попадает в один бин на 0 дБ и больше никуда. Сдвиньте его на полбина, и пик упадёт до -3.7 дБ и растечётся по всем бинам, потому что ДПФ считает окно одним периодом повторения, а повторение скачет на стыке. Окно Ханна сглаживает стык: при 8.5 бина на 64 точках оно опускает бин 20 с -33.2 дБ до -73.9 дБ. Спека signals.t27 вычисляет каждый бин.

Попробовать

Проведите тон от 8 до 9 бинов и следите за самым высоким бином; затем включите окно Ханна и сравните дальний бин.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Bins of a spectrum: one tone, and where it leaks
Bins of a spectrum: one tone, and where it leaks ↗

Slide a tone across the bins of a DFT. On a bin it is one clean bar; between bins it leaks everywhere, unless a window tapers the seam.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Бины спектра

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/bits-and-trits/index.html b/apps/website/public/ru/learn/bits-and-trits/index.html index 638eee10a2..72069030f8 100644 --- a/apps/website/public/ru/learn/bits-and-trits/index.html +++ b/apps/website/public/ru/learn/bits-and-trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Биты, триты и GF16

Вы узнаете

Как число хранится в битах и как сбалансированная троичная система хранит его в тритах.

Железо хранит числа как группы битов фиксированной длины, и t27 заставляет писать ширину: u8 — это 8 беззнаковых битов, i16 — 16 битов со знаком. t27 также говорит на сбалансированной троичной системе, где трит равен -1, 0 или +1. Для дробей есть GF16, 16-битное число с плавающей точкой: 1 бит знака, 6 битов экспоненты и 9 битов мантиссы. Введите число в калькулятор и посмотрите, как оно округляется, поле за полем, и насколько велика ошибка.

Попробуйте

Введите 1.618 и прочитайте биты экспоненты и мантиссы; затем введите 0.1 и посмотрите на ошибку.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GF16 calculator: a number as 16 GoldenFloat bits and as ternary
GF16 calculator: a number as 16 GoldenFloat bits and as ternary ↗

Type a number and see its GF16 sign, exponent and mantissa bit by bit, the exact value it rounds to, the error, and the same number in balanced ternary.

specs/tutorial/01_values_and_types.t27

// SPDX-License-Identifier: Apache-2.0
@@ -138,6 +170,7 @@ 

Биты, триты и GF16

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/blocked-is-not-failed/index.html b/apps/website/public/ru/learn/blocked-is-not-failed/index.html index 2c9c25f855..d18a923a42 100644 --- a/apps/website/public/ru/learn/blocked-is-not-failed/index.html +++ b/apps/website/public/ru/learn/blocked-is-not-failed/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Заблокирован — не значит провален

Вы узнаете

Почему правило, проверяемое при компиляции, останавливает спеку до запуска любого теста и чем это отличается от упавшего теста.

В браузере MAX_TRITS, равный 3, уронил две проверки. Нативный t27c строже: 8 инвариантов golden_sieve.t27 доказываются во время компиляции, поэтому с третьим тритом спека не компилируется вовсе. Отчёт пишет BLOCKED и объясняет, что заблокированная спека так и не дала бинарника, а значит, у неё нет результатов тестов. Правило, проверяемое при компиляции, не может уйти в сборку сломанным. Затем запись подкладывает другую ошибку: правило против ячеек сдвиговых регистров теперь всегда отвечает «да», и падает ровно один тест — тот, что проверяет формулу. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите строку, которая объясняет, почему у заблокированной спеки нет результатов тестов, и тест, который ломает вторая ошибка.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on golden_sieve.t27 -- the ternary sieve, native
t27c on golden_sieve.t27 -- the ternary sieve, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 3 tests pass natively; allowing a third trit trips a compile-time invariant and blocks the spec; letting S5 admit shift registers fails exactly one test; git restores the spec.

specs/numeric/golden_sieve.t27

// SPDX-License-Identifier: Apache-2.0
@@ -614,6 +646,7 @@ 

Заблокирован — не значит провален

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/board-selftest/index.html b/apps/website/public/ru/learn/board-selftest/index.html index ec7948942b..a74ea51e93 100644 --- a/apps/website/public/ru/learn/board-selftest/index.html +++ b/apps/website/public/ru/learn/board-selftest/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Стенд проверяет себя

Вы научитесь

Как стенд проверяет себя перед проверкой вашего дизайна.

Стенд проверяет себя раньше вашего дизайна: 16 скриптов, названных по spec, исполняют собственные --self-test, 0 плохих, а 8 скриптов без такого флага перечислены, а не молча пропущены — в этом разница между «всё хорошо» и «всё, что мы измерили». Виджет — этот прогон. Spec урока — fpga-selftest, инвентарь того, чем бывает самопроверка. Стенд, который не может сказать, какие его инструменты не проверены, — стенд, чьи вердикты несут неизвестные погрешности.

Попробуйте

Откройте прогон самопроверок и найдите 8 скриптов без флага; затем скажите, что даёт их перечисление вместо пропуска.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-selftest: off-board self-tests, no port opened
tri fpga-selftest: off-board self-tests, no port opened ↗

16 spec-named scripts run their own --self-test, 0 bad; 8 without the flag are listed, not skipped silently.

specs/tools/trios/tri/fpga-selftest.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Стенд проверяет себя

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/booths-trick/index.html b/apps/website/public/ru/learn/booths-trick/index.html index efb1049e2c..d03df79213 100644 --- a/apps/website/public/ru/learn/booths-trick/index.html +++ b/apps/website/public/ru/learn/booths-trick/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Приём Бута

Вы узнаете

Как перекодирование Бута по основанию 4 превращает восемь строк в четыре и обрабатывает знаковые числа без особого случая.

Читайте множитель по три бита, с перекрытием в один, с неявным 0 ниже бита 0. Каждая группа становится цифрой от -2 до +2, а каждая цифра — одним частичным произведением: цифра x a x 4^k. Для 3 x 6 цифры числа 6 равны -2, +2, 0, 0, и произведение равно -6 + 24 = 18. Именно отрицательные цифры заставляют дополнительный код работать без шага коррекции. Спека сверяет перекодирование с a x b для каждой пары 8-битных чисел, всех 65536.

Попробовать

Загрузите -128 x -128 и прочитайте цифры; затем сравните строки Бута, которые складываются, со строками сдвига и сложения для b = 127.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Booth's trick: half the partial products, signs for free
Booth's trick: half the partial products, signs for free ↗

Set two signed numbers and watch the multiplier recoded into digits -2..+2, read three bits at a time. Four partial products instead of eight, and two's complement just works.

specs/fpga/dsp/multipliers.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

Приём Бута

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/bounded-model-checking/index.html b/apps/website/public/ru/learn/bounded-model-checking/index.html index 083958020e..8b5c7ed79d 100644 --- a/apps/website/public/ru/learn/bounded-model-checking/index.html +++ b/apps/website/public/ru/learn/bounded-model-checking/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Ограниченная проверка моделей

Вы научитесь

Как ограниченный перебор исследует все входы до k тактов и что это доказывает.

Ограниченная проверка моделей — исчерпывающий поиск с горизонтом: все входы, все состояния, до k тактов — находится ли среди них нарушающий ассерт? Внутри границы это доказательство, а не выборка; никакой случайный сид не пропустит то, что перебор перечисляет. Spec урока несёт форму: глубина, таймаут, свойства для проверки. Виджет — ограниченный поиск в другой области: 84 журнала плат и моделей просмотрены в поисках ключа, которого нигде не должно быть, — 0 находок, 0 журналов, которые слишком велики, чтобы их прочесть, — отсутствие, проверенное перебором, а не предположенное.

Попробуйте

Назначьте глубину k и скажите точно, что ваш BMC-прогон доказывает и чего нет; затем найдите в прогоне по ключу, чего стоило «0 находок», чтобы быть проверенным, а не предположенным.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-keycheck: the key is counted, never printed
tri fpga-keycheck: the key is counted, never printed ↗

84 board and model logs scanned for the TRI-NET key: 0 hits, 0 logs of 1 MB or more.

specs/fpga/formal.t27

// SPDX-License-Identifier: Apache-2.0
@@ -422,6 +454,7 @@ 

Ограниченная проверка моделей

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/bring-up-on-the-bench/index.html b/apps/website/public/ru/learn/bring-up-on-the-bench/index.html index ff04654153..993b1b2525 100644 --- a/apps/website/public/ru/learn/bring-up-on-the-bench/index.html +++ b/apps/website/public/ru/learn/bring-up-on-the-bench/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Запуск на стенде

Вы узнаете

Как выглядит заранее зарегистрированный запуск на настоящем стенде, шаг за шагом.

Запуск — не импровизация: шаги зарегистрированы заранее, каждая команда записана, и то, что не выполнилось, записано так же, как то, что выполнилось. Виджет — план запуска Ethernet на этом стенде, tri fpga-steps, а спека — его карточка инструмента. Следующий модуль показывает дисциплину, оберегающую железо, которого касается план.

Попробовать

В записи посчитайте шаги и найдите один, который не выполнился; затем в спеке прочитайте, что карточка инструмента заявляет записывать.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-steps E3
tri fpga-steps E3 ↗

The Ethernet bring-up plan on the bench: pre-registered steps, logged exits, what ran and what did not

specs/tools/trios/tri/fpga-steps.t27

// SPDX-License-Identifier: Apache-2.0
@@ -107,6 +139,7 @@ 

Запуск на стенде

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/bugs-that-compile/index.html b/apps/website/public/ru/learn/bugs-that-compile/index.html index b9d0355349..79bbef775e 100644 --- a/apps/website/public/ru/learn/bugs-that-compile/index.html +++ b/apps/website/public/ru/learn/bugs-that-compile/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Баги, которые компилируются

Вы научитесь

Почему чистая компиляция доказывает так мало и чего стоит печать без вывода.

Всё здесь компилируется. Тестбенч UART в плеере зелёный на всех семи бэкендах — и всё же он почти ничего не доказывает: компиляция говорит, что слова разбираются и типы сходятся, а не что вы имели в виду именно эти слова. Виджет показывает ловушку покрупнее: у каждого слитого spec в t27 есть печать — хэш того, что произвела сборка; 31 из 1,428 печатей не записывают вывода вовсе, на 16 spec, и 3 из них нет в журнале долгов, который обязан их называть. Печать без вывода — зелёная галочка, под которой пусто; проверка начинается ровно здесь.

Попробуйте

Откройте разбор печатей и найдите 16 spec без вывода; затем откройте uart_tb в плеере и скажите вслух, чего не доказывает его компиляция.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri seals: hollow seals that pass every check
tri seals: hollow seals that pass every check ↗

31 of 1,428 seals record no output (16 specs); 3 of those are missing from the debt ledger.

specs/fpga/testbench/uart_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -464,6 +496,7 @@ 

Баги, которые компилируются

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/build-verify/index.html b/apps/website/public/ru/learn/build-verify/index.html index d525ab915b..9c12b6e337 100644 --- a/apps/website/public/ru/learn/build-verify/index.html +++ b/apps/website/public/ru/learn/build-verify/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сборка и проверка

Вы научитесь

Как одна команда пересобирает вердикт заново.

Сборка — не вердикт, пока её нельзя пересобрать одной командой и получить вердикт заново. Виджет — такая команда для стека битстримов: CRC 12/12 по эталонам, ECC 32520/32520 кадров, 82/82 пина, 4224/4224 сегбита, золото 5/5 — каждый прогон исполнен, у каждого счёта есть знаменатель, а последняя строка говорит: audit: CLEAN. Spec урока, build_verify, — тот же список, но как spec. Если проверки должен помнить человек, однажды их не прогонят.

Попробуйте

Запустите аудит и найдите счёт с самым большим знаменателем; затем прочитайте build_verify и отметьте, какие проверки пересчитываются, а не вспоминаются.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri x7-audit · the whole bitstream path, re-checked
tri x7-audit · the whole bitstream path, re-checked ↗

One command re-runs every sweep: CRC 12/12 over 6 reference bitstreams, ECC 32520/32520 frames, FAR walk = Vivado FDRI, 82/82 pins, 4224/4224 segbits, writer 16/16 and fasm 22/22 byte-identical to xc7frames2bit and fasm2frames, gold 5/5. audit: CLEAN.

specs/fpga/verification/build_verify.t27

// SPDX-License-Identifier: Apache-2.0
@@ -191,6 +223,7 @@ 

Сборка и проверка

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/bursts-and-ids/index.html b/apps/website/public/ru/learn/bursts-and-ids/index.html index 32657054b5..624c061c57 100644 --- a/apps/website/public/ru/learn/bursts-and-ids/index.html +++ b/apps/website/public/ru/learn/bursts-and-ids/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Пакеты и идентификаторы

Вы узнаете

Как описывается пакет, зачем нужен ID и что проверяет стенд AXI4.

Пакет — это один адрес и счётчик: AXI_LEN_WIDTH 8 означает до 256 тактов данных под одним адресом, а ID позволяет транзакциям мастера перемежаться и всё же приходить по порядку. Стенд это гоняет: test_reset_state, test_single_write, test_single_read, test_write_read_roundtrip, test_multiple_writes, восемь тестов. Запись опускает тестбенч-спеку AXI4 в Verilog.

Попробовать

В записи найдите тесты стенда; затем в спеке вычислите потолок пакета, который допускает ширина LEN, и скажите, что покупает ID.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on axi4_tb.t27 -- the testbench as RTL
t27c gen-verilog on axi4_tb.t27 -- the testbench as RTL ↗

The AXI4 testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/axi4_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -278,6 +310,7 @@ 

Пакеты и идентификаторы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/buses-and-peripherals/all/card.png b/apps/website/public/ru/learn/buses-and-peripherals/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..1f92f64a675c2f1f8360bd0d35c6cad6289a67d8 GIT binary patch literal 46180 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 uN$@{f3@5r-fB&8@57P$iS~K` literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/buses-and-peripherals/all/index.html b/apps/website/public/ru/learn/buses-and-peripherals/all/index.html new file mode 100644 index 0000000000..6cf61fa28d --- /dev/null +++ b/apps/website/public/ru/learn/buses-and-peripherals/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Шины и периферия на t27: UART, SPI, APB, AXI4, Ethernet: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

Шины и периферия на t27: UART, SPI, APB, AXI4, Ethernet

+

Он начинается там, где заканчивается курс о тактах. Каждый урок открывает настоящий инструмент или запись t27c на настоящей машине — рядом со спекой, которую можно запустить в браузере.

+

Курс 7, 27 уроков, в каждом виджет и спека t27: зачем существует шина, кадр UART, режимы SPI, рукопожатие APB, пять каналов AXI4, карты памяти, мосты, кадры Ethernet и тайминг RGMII, дисциплина работы со стендом. Каждое число взято из спеки или записанного прогона.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

0 из 27 пройдено

+

Открыть интерактивный курс →

+
+

Модуль 1 · Что такое шина

Зачем вообще существует шина: разговор по проводам, с кадрами и адресами, и кому позволено говорить.

+
+
01

Урок 1 из 27

Провода, которые говорят

+
+

Вы узнаетеЗачем нужна шина, сколько стоит двухпроводный разговор UART и что проверяет спека, открывающая курс.

Шина существует потому, что выводы дороги: двум чипам, которым надо поговорить, приходится делить провода, и провода несут разговор, о котором обе стороны договорились заранее. Простейший случай — UART из спеки этого урока, ZeroDSP_UART: два провода, без такта, обе стороны согласовали скорость — спека несёт UART_CLOCK_HZ равный 100,000,000 и UART_BAUD_RATE равный 115,200. Запись прогоняет t27c check по спеке: 0 ошибок, 0 предупреждений — стартовую планку, которую проходит спека каждого урока. Плеер компилирует её в вашем браузере.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите UART_CLOCK_HZ и UART_BAUD_RATE и разделите их, получив период бита.

+
t27c check on uart.t27 -- the spec compilesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/uart.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Кадрирование разговора

+
+

Вы узнаетеЧто меняет разговор под тактом и как спека SPI описывает свои режимы и частоты.

Разговору нужны правила, когда начинается и заканчивается слово, — иначе дальняя сторона считывает шум. Ответ под тактом — SPI, и спека этого урока, SPI_Master, заявляет основу: CLK_FREQ равен 50,000,000, SPI_CPOL и SPI_CPHA равны 0, максимальная ширина данных 32 бита. Запись прогоняет t27c check: 0 ошибок, 0 предупреждений. Три шины, которые открывает этот модуль, — UART, SPI и APB — это три ответа, которые курс разбирает по модулям.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите CLK_FREQ, CPOL и CPHA и скажите, какой режим конфигурирует спека.

+
t27c check on spi.t27 -- the spec compilesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/spi.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Хозяин и слуга

+
+

Вы узнаетеЧто такое шина регистров, кто ведёт и кто отвечает, и как APB называет роли.

Шина регистров задаёт разговору роли: один хозяин выставляет адреса, каждый слуга отвечает, когда его назвали. APB — эта шина в самом простом виде, а спека урока — её мост: ApbBridge с APB_ADDR_WIDTH 32, APB_DATA_WIDTH 32 и APB_STRB_WIDTH 4. Запись прогоняет t27c check: 0 ошибок, 0 предупреждений. Следующий через один модуль разбирает её рукопожатие по фазам.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите три ширины APB и скажите, что покрывает ширина строоба 4.

+
t27c check on apb_bridge.t27 -- the spec compilesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/apb_bridge.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Разговор по UART

Двухпроводная шина без такта: кадр, делитель, задающий скорость, и статус, который опрашивает драйвер.

+
+
04

Урок 4 из 27

Кадр: старт, данные, стоп

+
+

Вы узнаетеКак побитово собирается кадр UART и что компилятор порождает для него.

Кадр UART — атомы шины: линия в покое держится высоко, стартовый бит тянет её вниз, следуют восемь бит данных, и стоповый бит возвращает её высоко. Тестбенч-спека последнего урока этого модуля проверяет сам покой: uart_tb_tx_idle_high и uart_tb_rx_idle_high — два из её семи тестов. Запись показывает, как компилятор опускает спеку до синтезируемого Verilog: модуль ZeroDSP_UART, его порты clk, rst_n, en, data и ready, дата-путь как провода.

Попробовать

В записи найдите имя модуля и его порты; затем в спеке найдите константы ширины и глубины кадра и FIFO.

+
t27c gen-verilog on uart.t27 -- spec to RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/uart.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Бод и делитель

+
+

Вы узнаетеКак один делитель превращает такт в скорость битов и что ломает его смену.

Скорость — это делитель: такт, поделённый на бод, даёт период бита, и спека заявляет его константным выражением — UART_BIT_PERIOD равно UART_CLOCK_HZ / UART_BAUD_RATE, 100,000,000 на 115,200. Тест uart_configure_changes_baud_divisor проверяет, что конфигурация драйвера сдвигает делитель. Запись показывает спеку, опущенную в аппаратный IR: собственный взгляд компилятора на провода и состояние до того, как существует Verilog.

Попробовать

В записи проследите IR-вид делителя; затем в спеке найдите UART_BIT_PERIOD и тест, который его двигает.

+
t27c debug-hir on uart.t27 -- the bus as the compiler sees itВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/uart.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Статус и FIFO

+
+

Вы узнаетеЧто опрашивает драйвер, когда отправка отвергается и что проверяет тестбенч UART.

Драйверу нужно знать настроение железа: спека несёт STATUS_IDLE как 0, STATUS_TX_BUSY как 1, STATUS_RX_BUSY как 2 и FIFO глубиной 16 в каждую сторону. Тест uart_tx_send_returns_false_when_busy — правило, по которому живёт драйвер: нельзя толкать занятый передатчик. Запись опускает тестбенч-спеку UART в Verilog: как выглядит стенд, когда его порождает компилятор.

Попробовать

В записи найдите, что стенд печатает о линиях в покое; затем в спеке найдите три кода статуса и тест, отвергающий отправку в занятости.

+
t27c gen-verilog on uart_tb.t27 -- the testbench as RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/testbench/uart_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · SPI под тактом

Разговор под тактом: четыре режима, лестница предделителей и выбор кристалла на каждого подчинённого.

+
+
07

Урок 7 из 27

Режимы: CPOL и CPHA

+
+

Вы узнаетеЧто значат CPOL и CPHA, почему режимов четыре и какой конфигурирует спека.

CPOL выбирает уровень покоя такта, CPHA — какой фронт стробирует: четыре комбинации, четыре режима, и устройства, говорящие только на одном. Спека конфигурирует режим 0 — SPI_CPOL 0, SPI_CPHA 0 — и spi_mode_0_configuration это тест, который его прикалывает. Запись опускает спеку SPI в синтезируемый Verilog.

Попробовать

В записи найдите порты модуля, которые Verilog даёт мастеру SPI; затем в спеке найдите тест режима 0 и назовите, что выбирает каждый из CPOL и CPHA.

+
t27c gen-verilog on spi.t27 -- spec to RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/spi.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Лестница предделителей

+
+

Вы узнаетеКак лестница предделителей превращает один такт в семейство частот SCK и какие ступени допустимы.

Один такт становится семейством частот через лестницу предделителей: PRESCALER_2 равно 0, PRESCALER_4 равно 1, и лестница поднимается, пока такт держится. spi_prescaler_16_default проверяет значение по умолчанию, spi_set_prescaler_valid и spi_set_prescaler_invalid — границы, spi_sck_freq_at_50 — арифметику. Запись — нативный прогон: тестбенч-спека SPI через настоящий t27c, 7 тестов проходят.

Попробовать

В записи посчитайте проходящие тесты; затем в спеке перечислите константы предделителей и найдите тест, проверяющий значение по умолчанию.

+
t27c on spi_tb.t27 -- simulating the SPI testbenchВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/testbench/spi_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Выбор кристалла и ширины

+
+

Вы узнаетеКак выбор кристалла указывает слушателя и какой ширины бывает обмен.

Выбор кристалла — это адресация SPI: одну CS вниз — и этот слуга слушает, остальные держатся вверх и молчат. Спека даёт выбору его тайминг — CS_ASSERT_DELAY и CS_DEASSERT_DELAY по 100 нс каждый — а ширине границы: spi_set_data_width_8 и spi_set_data_width_32 обрамляют MAX_DATA_WIDTH равный 32. Запись опускает тестбенч-спеку SPI в Verilog.

Попробовать

В записи найдите Verilog стенда; затем в спеке найдите обе задержки CS и два теста ширины, обрамляющие максимум.

+
t27c gen-verilog on spi_tb.t27 -- the testbench as RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/testbench/spi_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Регистровая шина APB

Шина регистров: PSEL и PENABLE, строобы и ожидания, и сколько адресных бит стоит количество периферии.

+
+
10

Урок 10 из 27

PSEL и PENABLE

+
+

Вы узнаетеКак работает двухфазное рукопожатие APB и что компилятор порождает для моста.

APB ведёт пересылку в две фазы: setup, где PSEL называет слугу и адрес оседает, и access, где поднимается PENABLE и пересылка завершается. Перечисление ApbTransfer спеки несёт виды, а стенд двенадцатого урока гоняет через них запись и чтение. Запись опускает спеку моста APB в синтезируемый Verilog: список портов, разводку, дешифрацию.

Попробовать

В записи найдите список портов моста; затем в спеке найдите виды ApbTransfer и скажите, какую фазу называет PENABLE.

+
t27c gen-verilog on apb_bridge.t27 -- spec to RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/apb_bridge.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Строобы и ожидания

+
+

Вы узнаетеЧто значат байты строоба, когда слуга держит шину и как это видит IR.

Байты строоба говорят, какие линии слова несут данные: strb_width_32bit и strb_width_16bit — два из восемнадцати тестов спеки, одно слово подаётся целиком, одно полсловом. Медленный слуга держит шину состоянием ожидания вместо догадки. Запись показывает мост APB как аппаратный IR: PSEL, PENABLE и дешифрацию в той структуре, которую даёт компилятор.

Попробовать

В записи найдите PSEL и PENABLE в IR; затем в спеке найдите два теста ширины строоба и скажите, что стробирует пересылка полслова.

+
t27c debug-hir on apb_bridge.t27 -- the handshake as IRВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/apb_bridge.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Дешифрация адреса

+
+

Вы узнаетеСколько адресных бит стоит количество периферии и что проверяет стенд моста.

Адресация на APB — вопрос бит: сколько слуг сидит за мостом, столько бит дешифрация тратит. Спека отвечает по счёту — addr_bits_for_1_peripheral, addr_bits_for_4_peripherals, addr_bits_for_8_peripherals — а её тестбенч гоняет результат: test_reset_state, test_apb_write, test_apb_read, test_write_read_roundtrip, test_multiple_apb_writes, восемь тестов. Запись опускает тестбенч-спеку моста APB в Verilog.

Попробовать

В записи найдите тесты стенда; затем в спеке вычислите, сколько адресных бит спека тратит на 8 периферий.

+
t27c gen-verilog on apb_bridge_tb.t27 -- the testbench as RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/testbench/apb_bridge_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Пять каналов AXI4

Пять каналов: адрес, данные и отклик в обе стороны, lite или full, пакеты и идентификаторы.

+
+
13

Урок 13 из 27

Пять каналов

+
+

Вы узнаетеЧто несут пять независимых каналов AXI4 и что компилятор порождает для них.

AXI4 несёт пять независимых каналов: адрес записи, данные записи, отклик записи, адрес чтения, данные чтения. Спека заявляет ширины — AXI_ADDR_WIDTH 32, AXI_DATA_WIDTH 32, AXI_STRB_WIDTH 4, AXI_ID_WIDTH 4, AXI_LEN_WIDTH 8, AXI_SIZE_WIDTH 3 — под MAX_BUS_PORTS равным 32. Запись опускает спеку AXI4 в синтезируемый Verilog: разводку каналов и рукопожатия как порождённые провода.

Попробовать

В записи найдите каналы в порождённых проводах; затем в спеке перечислите шесть ширин AXI и скажите, что покрывает 8-битный LEN.

+
t27c gen-verilog on axi4.t27 -- spec to RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/axi4.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Lite или full

+
+

Вы узнаетеЧто AXI4 Lite оставляет и что выбрасывает, и чего валидация требует от шины.

Lite — то же рукопожатие с вынутой механикой пакетов: без LEN, без лестницы размеров, одна пересылка за раз. Перечисление AxiKind спеки несёт lite и full, и её тесты называют разницу — axi4_lite_is_lite, axi4_full_is_full — и правила валидации: validate_lite_ok, validate_full_ok, validate_empty_name, validate_zero_addr. Запись прогоняет t27c check по спеке: 0 ошибок, 0 предупреждений.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите значения AxiKind и четыре теста валидации.

+
t27c check on axi4.t27 -- the spec compilesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/axi4.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Пакеты и идентификаторы

+
+

Вы узнаетеКак описывается пакет, зачем нужен ID и что проверяет стенд AXI4.

Пакет — это один адрес и счётчик: AXI_LEN_WIDTH 8 означает до 256 тактов данных под одним адресом, а ID позволяет транзакциям мастера перемежаться и всё же приходить по порядку. Стенд это гоняет: test_reset_state, test_single_write, test_single_read, test_write_read_roundtrip, test_multiple_writes, восемь тестов. Запись опускает тестбенч-спеку AXI4 в Verilog.

Попробовать

В записи найдите тесты стенда; затем в спеке вычислите потолок пакета, который допускает ширина LEN, и скажите, что покупает ID.

+
t27c gen-verilog on axi4_tb.t27 -- the testbench as RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/testbench/axi4_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Память

Что находится на дальнем конце каждой шины: карты памяти, типы портов и задержка, которую должно покрывать ожидание.

+
+
16

Урок 16 из 27

Карты памяти

+
+

Вы узнаетеКак объявляется карта памяти, что значат BRAM и ROM как типы и что проверяют 15 нативных тестов.

Карта памяти — это кто живёт по какому адресу: перечисление MemKind спеки несёт типы, а make_bram_has_depth, make_bram_small и make_bram_single — три из её пятнадцати тестов. Запись — нативный прогон: спека памяти через настоящий t27c, 15 тестов проходят и 6 инвариантов доказаны comptime — из всего семейства шин нативный раннер берёт её целиком, больше ни одну так.

Попробовать

В записи посчитайте проходящие тесты и доказанные инварианты; затем в спеке найдите значения MemKind и три теста make_bram.

+
t27c on memory.t27 -- the memory map, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/memory.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Порты и типы

+
+

Вы узнаетеЧто такое порт у памяти, сколько их может быть и кому позволено писать.

Порт — это дорога в память: чтение, запись или обе, и MAX_MEM_PORTS 8 их ограничивает. add_read_port_increments, add_write_port_increments и add_rw_port проверяют счёт, is_rom проверяет, что тип только-для-чтения отвергает порт записи. Запись прогоняет t27c check по спеке: 0 ошибок, 0 предупреждений.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите MAX_MEM_PORTS и тест, отвергающий порт записи на ROM.

+
t27c check on memory.t27 -- the spec compilesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/memory.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Задержка

+
+

Вы узнаетеВ скольких тактах память отвечает и что стенд памяти проверяет в чтении и записи.

Каждый ответ стоит тактов, и перечисление MemLatency спеки несёт типы, которые должно покрывать состояние ожидания. Стенд проверяет поведение: test_reset_clears, test_write_read_single, test_write_read_multiple, test_overwrite, test_all_zero_bits, девять тестов. Запись опускает тестбенч-спеку памяти в Verilog.

Попробовать

В записи найдите тесты стенда; затем в спеке найдите типы MemLatency и скажите, что должно покрывать состояние ожидания.

+
t27c gen-verilog on memory_tb.t27 -- the testbench as RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/testbench/memory_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Мосты

Почему в дизайне появляется больше одной шины и пакетный мост, переносящий работу между ними.

+
+
19

Урок 19 из 27

Зачем мосты

+
+

Вы узнаетеПочему в дизайне появляется больше одной шины и что спека моста проверяет о собственном состоянии.

Дизайн выращивает больше одной шины, потому что периферия и вычисления различаются: медленная шина регистров для ручек, широкая — для данных. Спека моста, FPGA_Bridge, — это переход этого дизайна, и bridge_initially_idle и bridge_rx_buffers_empty — два из её двадцати одного теста. Запись прогоняет t27c check: 0 ошибок, 0 предупреждений.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите два теста покоя и посчитайте тесты спеки.

+
t27c check on bridge.t27 -- the spec compilesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/bridge.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Пакетный мост

+
+

Вы узнаетеКак пакетный мост переносит работу между шинами и чего стоят его буферы.

Пакетный мост переносит работу между шинами пакетами: буферы RX и TX по 256 байт каждый, SPI-буфер на 64, MAX_PACKET_SIZE 128, PACKET_TIMEOUT 10,000 тактов и коды операций OP_MAC_MUL, OP_MAC_MAC и OP_MAC_MACC для работы, которую он несёт. bridge_buffer_count_wrap и bridge_buffer_count_wrap2 проверяют арифметику на шве. Запись опускает спеку моста в синтезируемый Verilog.

Попробовать

В записи найдите порты модуля моста; затем в спеке найдите четыре константы буферов и таймаут, а также три кода операций.

+
t27c gen-verilog on bridge.t27 -- spec to RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/bridge.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

Всё в одном стенде

+
+

Вы узнаетеЧто проверяет интеграционный стенд, когда все шины дизайна гоняются одновременно.

Интеграционный стенд гоняет все шины разом и спрашивает дизайн, держится ли он целиком: test_reset_all_modules, test_module_count, test_mac_uart_pipeline, test_spi_memory_pipeline, test_full_pipeline, семь тестов. Запись опускает тестбенч-спеку интеграции в Verilog: все шины дизайна в одном стенде.

Попробовать

В записи найдите пять тестов конвейеров; затем в спеке скажите, какие две шины соединяет интеграционный стенд.

+
t27c gen-verilog on integration_tb.t27 -- the integration benchВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/testbench/integration_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Ethernet: кадры и тайминг

Кадры, контрольная сумма кадра, тайминг RGMII и заранее зарегистрированные шаги настоящего запуска.

+
+
22

Урок 22 из 27

Кадры и контрольная сумма

+
+

Вы узнаетеКак кадр Ethernet заканчивается CRC-32 и что вычисляет проверка.

Кадр Ethernet заканчивается контрольной суммой кадра: CRC-32 по байтам, вычисленная отправителем и пересчитанная получателем. Спека этого урока, написанная для этого курса, несёт полином и арифметику, а её заголовок помечает, на что проверка претендует и на что нет. Запись прогоняет t27c по ней.

Попробовать

В записи проследите прогон; затем в спеке найдите полином, который использует CRC-32, и что заголовок помечает как допущение.

+
t27c on eth_crc.t27 -- the FCS, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/eth_crc.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Тайминг RGMII

+
+

Вы узнаетеЧто тайминг RGMII требует от полубайта на двух фронтах и что спека о нём утверждает.

RGMII переносит полубайт за фронт такта, на обоих фронтах: двойная скорость данных на 125 МГц для гигабита и одинарная для 10 и 100. Спека этого урока, написанная для этого курса, несёт тайминговую арифметику и свои допущения в заголовке. Запись прогоняет t27c по ней.

Попробовать

В записи проследите прогон; затем в спеке найдите частоту DDR и что спека говорит о понижении до 10 и 100.

+
t27c on rgmii.t27 -- RGMII timing, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/rgmii.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Запуск на стенде

+
+

Вы узнаетеКак выглядит заранее зарегистрированный запуск на настоящем стенде, шаг за шагом.

Запуск — не импровизация: шаги зарегистрированы заранее, каждая команда записана, и то, что не выполнилось, записано так же, как то, что выполнилось. Виджет — план запуска Ethernet на этом стенде, tri fpga-steps, а спека — его карточка инструмента. Следующий модуль показывает дисциплину, оберегающую железо, которого касается план.

Попробовать

В записи посчитайте шаги и найдите один, который не выполнился; затем в спеке прочитайте, что карточка инструмента заявляет записывать.

+
tri fpga-steps E3Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/fpga-steps.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · Стенд

Дисциплина, оберегающая настоящее железо: кто держит IO, как взять и вернуть захват, и что запускается дальше.

+
+
25

Урок 25 из 27

Кто держит IO

+
+

Вы узнаетеКто сейчас держит IO стенда и что заявляют зарегистрированные клиенты.

Железо, которым делятся, — это железо, которое занимают на время: стенд регистрирует своих клиентов IO, и запись читает их вживую — имена, захваты и то, что каждый заявляет своим. Спека — карточка инструмента tri fpga-ioclients. Урок замыкает круг, открытый курсом: шина, её спека, её стенд — и теперь руки на нём.

Попробовать

В записи перечислите клиентов, которых отчитывает стенд; затем в спеке найдите, что клиент должен заявить для регистрации.

+
tri fpga-ioclients -- who holds the bench IOВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/fpga-ioclients.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Захват и возврат

+
+

Вы узнаетеКак берётся и возвращается захват и почему дисциплина важна.

Захват — это обещание: один клиент держит замок, работает и возвращает его. Запись берёт захват командой tri fpga-claim, а следующий за ней чип возвращает его tri fpga-release — взято и отдано, записанные подряд, стенд отчитывает, кто держит, а потом самого себя свободным. Спека — карточка инструмента tri fpga-claim.

Попробовать

В записи проследите, как ложится захват и как возврат; затем в спеке найдите, что tri fpga-claim отвергает, когда замок занят.

+
tri fpga-claim -- taking the bench lockВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/fpga-claim.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Капстоун: что запускается дальше

+
+

Вы узнаетеКак куски курса сходятся в один дизайн и что запускается на стенде дальше.

Закройте курс там, где он начался, — у целого дизайна: top_level.t27 несёт CLK_FREQ_HZ 100,000,000, SYSTICK_HZ 1000, NUM_MAC_UNITS 8, DATA_WIDTH 32 и коды операций CMD_NOP, CMD_MAC_MULT, CMD_MAC_DOT и CMD_UART_SEND — девятнадцать тестов дизайна, который держит все шины, разобранные этим курсом. Запись читает, что стенд запускает дальше; боковые кнопки опускают весь дизайн в Verilog — и его верхний стенд вместе с ним.

Попробовать

В записи прочитайте, что запускается дальше; затем в спеке найдите четыре кода операций и посчитайте тесты дизайна.

+
tri fpga-next -- what the bench wants nextВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/top_level.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Что такое шина
    1. 01 Провода, которые говорят
    2. 02 Кадрирование разговора
    3. 03 Хозяин и слуга
  2. 02 · Разговор по UART
    1. 04 Кадр: старт, данные, стоп
    2. 05 Бод и делитель
    3. 06 Статус и FIFO
  3. 03 · SPI под тактом
    1. 07 Режимы: CPOL и CPHA
    2. 08 Лестница предделителей
    3. 09 Выбор кристалла и ширины
  4. 04 · Регистровая шина APB
    1. 10 PSEL и PENABLE
    2. 11 Строобы и ожидания
    3. 12 Дешифрация адреса
  5. 05 · Пять каналов AXI4
    1. 13 Пять каналов
    2. 14 Lite или full
    3. 15 Пакеты и идентификаторы
  6. 06 · Память
    1. 16 Карты памяти
    2. 17 Порты и типы
    3. 18 Задержка
  7. 07 · Мосты
    1. 19 Зачем мосты
    2. 20 Пакетный мост
    3. 21 Всё в одном стенде
  8. 08 · Ethernet: кадры и тайминг
    1. 22 Кадры и контрольная сумма
    2. 23 Тайминг RGMII
    3. 24 Запуск на стенде
  9. 09 · Стенд
    1. 25 Кто держит IO
    2. 26 Захват и возврат
    3. 27 Капстоун: что запускается дальше
+ + + + + diff --git a/apps/website/public/ru/learn/buses-and-peripherals/index.html b/apps/website/public/ru/learn/buses-and-peripherals/index.html index ceb398b481..8e03b538d8 100644 --- a/apps/website/public/ru/learn/buses-and-peripherals/index.html +++ b/apps/website/public/ru/learn/buses-and-peripherals/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

Шины и периферия на t27: UART, SPI, APB, AXI4, Ethernet

Он начинается там, где заканчивается курс о тактах. Каждый урок открывает настоящий инструмент или запись t27c на настоящей машине — рядом со спекой, которую можно запустить в браузере.

Курс 7, 27 уроков, в каждом виджет и спека t27: зачем существует шина, кадр UART, режимы SPI, рукопожатие APB, пять каналов AXI4, карты памяти, мосты, кадры Ethernet и тайминг RGMII, дисциплина работы со стендом. Каждое число взято из спеки или записанного прогона.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/capstone-a-filter-on-the-board/index.html b/apps/website/public/ru/learn/capstone-a-filter-on-the-board/index.html index e05cb94460..6e5ef0d8b5 100644 --- a/apps/website/public/ru/learn/capstone-a-filter-on-the-board/index.html +++ b/apps/website/public/ru/learn/capstone-a-filter-on-the-board/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Итог: фильтр на плате

Вы узнаете

Как арифметика курса сходится в одном фильтре, посчитанном бит в бит так, как считает плата.

Рассчитайте ФНЧ из урока 17, подайте на него тон из полосы пропускания и тон из полосы задерживания 16-битными отсчётами и исполните его так, как это делает RTL: целые коэффициенты, широкий аккумулятор, округление половины вверх, насыщение до 16 бит. С 31 коэффициентом Хэмминга по 16 бит тон из полосы задерживания исчезает, аккумулятору нужно 32 бита, глубоко внутри 48 у DSP48E1, а выход остаётся в пределах 1.5 LSB от того же фильтра в f64. Чтобы поставить его на плату, кнопки ниже открывают квитанцию сборки и путь JTAG.

Попробовать

Уменьшите биты коэффициентов до 8 и посмотрите на столбики ошибки; затем перенесите тон из полосы задерживания в полосу пропускания и объясните выход.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Capstone: a filter as the board computes it
Capstone: a filter as the board computes it ↗

Design a low-pass, feed it two tones as 16-bit samples and see what the RTL arithmetic outputs next to the same filter in f64, down to the last bit.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Итог: фильтр на плате

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/capstone-diff/index.html b/apps/website/public/ru/learn/capstone-diff/index.html index 5161309c72..dd1775e4ae 100644 --- a/apps/website/public/ru/learn/capstone-diff/index.html +++ b/apps/website/public/ru/learn/capstone-diff/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Капстоун: поменяй и сравни

Вы узнаете

Как куски курса сходятся в одной сборке и что говорит дифф битстрима об изменении.

Замкните круг: поменяйте в пересечении одну вещь — ступень синхронизатора, указатель Грея, ограничение — пересоберите и спросите битстрим, что сдвинулось. Виджет сравнивает два битстрима Xilinx 7-й серии в браузере: заголовок, пакеты и каждый кадр из 101 слова, с декодированным адресом отличающегося кадра; ничего не загружается наружу. Изменение CDC, утверждающее, что оно ничего не меняет, должно давать пустой дифф, а осмысленное — показывает, какие кадры оно задело. Окно спеки открывает fifo.t27, буфер, который этот курс построил пересечение за пересечением, и его 18 прошедших тестов — квитанция.

Попробуйте

В виджете бросьте два битстрима, если они есть, и найдите отличающийся кадр; затем в окне спеки выберите один тест FIFO и скажите, какое изменение его сломало бы.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri blog list: every t27.ai post and its receipt state
tri blog list: every t27.ai post and its receipt state ↗

73 published posts with date, language and revision, newest first.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Капстоун: поменяй и сравни

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/capstone-what-runs-next/index.html b/apps/website/public/ru/learn/capstone-what-runs-next/index.html index a315adbfe0..1d4c81e761 100644 --- a/apps/website/public/ru/learn/capstone-what-runs-next/index.html +++ b/apps/website/public/ru/learn/capstone-what-runs-next/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Капстоун: что запускается дальше

Вы узнаете

Как куски курса сходятся в один дизайн и что запускается на стенде дальше.

Закройте курс там, где он начался, — у целого дизайна: top_level.t27 несёт CLK_FREQ_HZ 100,000,000, SYSTICK_HZ 1000, NUM_MAC_UNITS 8, DATA_WIDTH 32 и коды операций CMD_NOP, CMD_MAC_MULT, CMD_MAC_DOT и CMD_UART_SEND — девятнадцать тестов дизайна, который держит все шины, разобранные этим курсом. Запись читает, что стенд запускает дальше; боковые кнопки опускают весь дизайн в Verilog — и его верхний стенд вместе с ним.

Попробовать

В записи прочитайте, что запускается дальше; затем в спеке найдите четыре кода операций и посчитайте тесты дизайна.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-next -- what the bench wants next
tri fpga-next -- what the bench wants next ↗

The next queued step on the bench, read live from the run state.

specs/fpga/top_level.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

Капстоун: что запускается дальше

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/capstone/index.html b/apps/website/public/ru/learn/capstone/index.html index b157c57da3..c078580794 100644 --- a/apps/website/public/ru/learn/capstone/index.html +++ b/apps/website/public/ru/learn/capstone/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Итог: переугадайте yosys

Вы узнаете

Соберите всё вместе: угадайте, сколько LUT стоит настоящий модуль t27.

Всё из этого курса в одной игре. Каждый день Gatle показывает один настоящий модуль t27 и Verilog, который ваш браузер из него компилирует; у вас шесть попыток угадать, сколько LUT на него потратил yosys. Используйте то, что знаете: ширины, умножители, иерархию, состояние. Потом посмотрите, как ещё люди и агенты соревнуются на t27.

Попробуйте

Сыграйте сегодняшнюю задачу. Затем прочитайте Verilog модуля и объясните, почему он стоил столько, сколько стоил. Запустите тесты в спеке: сколько из 12 инструкций hello_kernel — операции GF16 и какой тест говорит, что все 12 занимают 48 байт?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Gatle: guess how many LUTs yosys spends on today's t27 module
Gatle: guess how many LUTs yosys spends on today's t27 module ↗

A daily guessing game: one real t27 module, its Verilog compiled in your browser, six guesses at the LUT count yosys reported for it.

specs/fpga/e2e_demo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -320,6 +352,7 @@ 

Итог: переугадайте yosys

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/capture-a-crossing/index.html b/apps/website/public/ru/learn/capture-a-crossing/index.html index 664b687fed..667b3e2129 100644 --- a/apps/website/public/ru/learn/capture-a-crossing/index.html +++ b/apps/website/public/ru/learn/capture-a-crossing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Захватить пересечение

Вы узнаете

Как захватили одно пересечение в точке, где оно приземляется: на самих RX-приёмных триггерах, и что напечатал записанный запуск.

Одно пересечение, захваченное там, где оно приземляется: на самих RX-приёмных триггерах. Команда tri fpga-rxcap моделирует захват E3 RX на плате AX7203 (XC7A200T в корпусе FBG484) в том же SDF, что и прошлый модуль, и её записанный запуск напечатал: hold по спадающему фронту 10900 пс на rxctl_n, при RXC на 2,4 нс позади своих данных через BUFG, так что rxd_p1 и полубайт RX_ER снимают новое значение в окне, которое модель называет. Спека — карточка инструмента: константы для страницы инструмента, 0 тестов, и запись показывает, как нативный отчёт говорит именно это. Выводы, которые она захватывает, — дальний конец каждого урока перед этим.

Попробуйте

В записи найдите записанный запас hold и задержку через BUFG; затем в окне спеки прочитайте источники данных карточки и скажите, чего модель не измеряла.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on fpga-rxcap.t27 -- the RX capture card, native
t27c on fpga-rxcap.t27 -- the RX capture card, native ↗

The tri fpga-rxcap tool-card spec reports 0 tests -- constants for a tool page, not a test suite; the first lines show what it carries.

specs/tools/trios/tri/fpga-rxcap.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Захватить пересечение

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/carry-save/index.html b/apps/website/public/ru/learn/carry-save/index.html index 3fb7ee5be6..f356683e09 100644 --- a/apps/website/public/ru/learn/carry-save/index.html +++ b/apps/website/public/ru/learn/carry-save/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Три числа сразу

Вы узнаете

Как счётчики 3:2 складывают много чисел почти без распространения переноса и сколько слоёв нужно для k чисел.

Счётчик 3:2 — это ряд полных сумматоров без связей между ними: на входе три числа, на выходе слово суммы и слово переноса, и эти два в сумме дают те три. Слои таких счётчиков сжимают k чисел до двух, а затем их доскладывает один обычный сумматор. Высоты Дадды 2, 3, 4, 6, 9, 13, 19, 28, 42, 63 — наибольшее число слагаемых, которое сводит каждое количество слоёв, поэтому 9 числам нужно 4 слоя, а 64 — 10. Для 9 чисел по 16 бит это 20 задержек полного сумматора против 128 у цепочки сумматоров.

Попробовать

Задайте 28 чисел, а затем 29: сколько слоёв нужно каждому и почему одно лишнее число стоит слоя? Затем проверьте в счётчике ниже, что сумма + перенос равны a + b + c.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Carry-save adders: add many numbers with almost no carries
Carry-save adders: add many numbers with almost no carries ↗

Set how many numbers to add and watch 3:2 counters squeeze them to two, layer by layer, before a single carry-propagate adder. Then try one counter on three numbers.

specs/fpga/dsp/adders.t27

// SPDX-License-Identifier: Apache-2.0
@@ -552,6 +584,7 @@ 

Три числа сразу

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/cdc-report/index.html b/apps/website/public/ru/learn/cdc-report/index.html index a4ced7c45f..2685393cb0 100644 --- a/apps/website/public/ru/learn/cdc-report/index.html +++ b/apps/website/public/ru/learn/cdc-report/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Отчёт CDC

Вы узнаете

Что перечисляет отчёт CDC и о чём спрашивает каждое пересечение, и что общего у него с отчётом проверенных вещей.

Отчёт CDC проходит по каждому пересечению нетлиста и спрашивает: синхронизировано, и насколько? Он называет несинхронизированные пути, синхронизаторы со слишком малым числом ступеней, шины, забывшие свой Грей. Виджет — другой отчёт из названных вещей, каждая проверена: 129 файлов целы против новейшего из 54 снимков с адресацией по содержимому — не отчёт CDC, но та же форма: список, где каждая строка — вердикт с источником. Окно спеки открывает timing.t27, арифметику, на которую такой отчёт опирается, оценивая надёжность синхронизатора.

Попробуйте

В виджете найдите, сколько файлов отчёт держит целыми и против скольких снимков он проверяет; затем в окне спеки найдите оценку, которую отчёт CDC прогонял бы по каждому пересечению.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri game-vault: the loop's skills checked against snapshots
tri game-vault: the loop's skills checked against snapshots ↗

129 files intact against the newest of 54 content-addressed snapshots.

specs/fpga/timing.t27

// SPDX-License-Identifier: Apache-2.0
@@ -446,6 +478,7 @@ 

Отчёт CDC

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/chip-select-and-widths/index.html b/apps/website/public/ru/learn/chip-select-and-widths/index.html index 934314737d..45ffe20308 100644 --- a/apps/website/public/ru/learn/chip-select-and-widths/index.html +++ b/apps/website/public/ru/learn/chip-select-and-widths/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Выбор кристалла и ширины

Вы узнаете

Как выбор кристалла указывает слушателя и какой ширины бывает обмен.

Выбор кристалла — это адресация SPI: одну CS вниз — и этот слуга слушает, остальные держатся вверх и молчат. Спека даёт выбору его тайминг — CS_ASSERT_DELAY и CS_DEASSERT_DELAY по 100 нс каждый — а ширине границы: spi_set_data_width_8 и spi_set_data_width_32 обрамляют MAX_DATA_WIDTH равный 32. Запись опускает тестбенч-спеку SPI в Verilog.

Попробовать

В записи найдите Verilog стенда; затем в спеке найдите обе задержки CS и два теста ширины, обрамляющие максимум.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on spi_tb.t27 -- the testbench as RTL
t27c gen-verilog on spi_tb.t27 -- the testbench as RTL ↗

The SPI testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/spi_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Выбор кристалла и ширины

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/claim-and-release/index.html b/apps/website/public/ru/learn/claim-and-release/index.html index 7b5e817704..c846789ddb 100644 --- a/apps/website/public/ru/learn/claim-and-release/index.html +++ b/apps/website/public/ru/learn/claim-and-release/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Захват и возврат

Вы узнаете

Как берётся и возвращается захват и почему дисциплина важна.

Захват — это обещание: один клиент держит замок, работает и возвращает его. Запись берёт захват командой tri fpga-claim, а следующий за ней чип возвращает его tri fpga-release — взято и отдано, записанные подряд, стенд отчитывает, кто держит, а потом самого себя свободным. Спека — карточка инструмента tri fpga-claim.

Попробовать

В записи проследите, как ложится захват и как возврат; затем в спеке найдите, что tri fpga-claim отвергает, когда замок занят.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-claim -- taking the bench lock
tri fpga-claim -- taking the bench lock ↗

The bench claim in action: one client takes the hardware lock and the tool reports who holds it.

specs/tools/trios/tri/fpga-claim.t27

// SPDX-License-Identifier: Apache-2.0
@@ -107,6 +139,7 @@ 

Захват и возврат

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/clocks-and-cdc/all/card.png b/apps/website/public/ru/learn/clocks-and-cdc/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..572333297d85f9914c33a7916ce05eaeb8a16b98 GIT binary patch literal 47656 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

er6Skb+)L{1;A5s^X?vH0g1 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 AqW}N^ literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/clocks-and-cdc/all/index.html b/apps/website/public/ru/learn/clocks-and-cdc/all/index.html new file mode 100644 index 0000000000..3ff4149c15 --- /dev/null +++ b/apps/website/public/ru/learn/clocks-and-cdc/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Тактирование, сброс и пересечения тактовых доменов на t27: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

Тактирование, сброс и пересечения тактовых доменов на t27

+

Он продолжает курс по ИИ-числам с того места, где тот заканчивается. Каждый урок открывает настоящий инструмент или запись t27c на настоящей машине рядом со спекой, которую можно запустить в браузере.

+

Курс 3, 27 уроков, в каждом виджет и спека t27: что такое тактовый сигнал и где он входит в плату, дерево тактового сигнала, MMCM, три вида сброса, метастабильность и MTBF, пересечение многих бит, асинхронный FIFO, файл ограничений и чтение пересечений на реальном железе. Каждое число взято из спеки или из записанного запуска.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

Пройдено 0 из 27

+

Открыть интерактивный курс →

+
+

Модуль 1 · Что такое тактовый сигнал

Один фронт, один мир: всё, что делит фронт тактового сигнала, делит и мир; период и джиттер настоящего фронта и место, где тактовый сигнал входит в плату.

+
+
01

Урок 1 из 27

Один фронт, один мир

+
+

Вы узнаетеЧто такое тактовый домен, четыре названных в clock_domain.t27 способа его пересечь и что проверяет нативный компилятор.

Тактовый домен — это все триггеры, которые делят один фронт тактового сигнала. Перенесите сигнал между двумя доменами — и принимающий фронт может снять его посреди изменения: этому и посвящён курс. clock_domain.t27 называет в одном перечислении четыре способа перехода: no_cross, two_flop, fifo_async, handshake. Модуль 5 разбирает two_flop, модуль 6 — рукопожатие, модуль 7 — FIFO. Запись запускает нативный t27c на этой спеке: проходят 12 тестов, а 5 инвариантов доказываются при компиляции. Плеер компилирует спеку в браузере; где браузер не может выполнить проверку, он пропускает её и объясняет почему.

Попробуйте

В записи посчитайте прошедшие тесты и доказанные инварианты; затем в окне спеки найдите четыре стратегии пересечения и назовите модуль курса, который разбирает каждую.

+
t27c on clock_domain.t27 -- the CDC spec, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/clock_domain.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Период, фронт и джиттер

+
+

Вы узнаетеЧто несёт тактовый сигнал кроме частоты, что джиттер делает с фронтом и зачем нужна спека карточки инструмента.

Тактовый сигнал — это период с фронтом внутри, и фронт стоит не идеально: от цикла к циклу он гуляет на величину джиттера. Спека карточки инструмента tri clocks — не набор тестов, и запись показывает, как нативный отчёт говорит именно это: 0 тестов, потому что это константы, которые читает страница инструмента. Каждая константа на той карточке называет вывод инструмента, из которого она взята. Джиттер съедает запас, который оставляет расчёт setup: спека дерева тактового сигнала из следующего модуля несёт 50 пс джиттера PLL как одну из своих констант.

Попробуйте

В записи найдите строку, объясняющую, почему отчёт насчитал 0 тестов; затем в окне спеки прочитайте константы и найдите, где каждая называет вывод инструмента, из которого она взята.

+
t27c on clocks.t27 -- the tri clocks card, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/clocks.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Где входит тактовый сигнал

+
+

Вы узнаетеОткуда на самом деле берётся тактовый сигнал платы и как кольцевой генератор внутри кристалла измерили на трёх кристаллах через JTAG.

Тактовый сигнал входит в плату, а не в кристалл: генератор на печатной плате ведёт вывод. Спека платы QMTech Wukong (XC7A200T в корпусе FGG676, деталь xc7a200tfgg676) ещё и измеряет тактовый сигнал, который не покидает кристалл: CFGMCLK — кольцевой генератор без кварца. UG470 даёт номинал 65 МГц в коридоре 50-80 МГц. Его измерили на трёх подключённых кристаллах, хронометрируя прескалер 2^24 через JTAG: 70770, 68490 и 67200 кГц. Запись запускает нативный t27c на спеке платы: проходят 15 тестов, 11 инвариантов доказаны comptime.

Попробуйте

В записи найдите три измеренных значения CFGMCLK и номера busdev их кристаллов; затем в окне спеки найдите коридор UG470, с которым их сравнивают, и прескалер, который сделал их читаемыми.

+
t27c on wukong_v1.t27 -- the board spec, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/boards/wukong_v1.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Деревья тактового сигнала

Перекос и задержка прохождения, глобальная сеть буферов и ловушка стробирования клока логикой.

+
+
04

Урок 4 из 27

Перекос и задержка прохождения

+
+

Вы узнаетеПочему тактовый сигнал не доходит до всех триггеров одновременно и чего стоят задержки дерева кристалла 7-й серии.

Тактовый сигнал не приходит ко всем триггерам одновременно: он идёт через дерево, и разброс времён прихода — это перекос, skew. cts.t27 моделирует это дерево с учебными задержками Artix-7 в шапке: BUFH 0,05 нс, BUFG 0,1 нс, джиттер PLL 50 пс и целевой максимум перекоса 100 пс. Запись запускает нативный t27c на ней: проходят 15 тестов, 2 инварианта доказаны comptime. Перекос — не шум, который надо убрать, а бюджет, который надо потратить: сбалансированное дерево тратит его равномерно, и только поэтому вообще возможен один общий фронт.

Попробуйте

В записи найдите две задержки буферов в шапке; затем в окне спеки найдите целевой максимум перекоса и тест, сравнивающий фан-аут буферов.

+
t27c on cts.t27 -- clock-tree synthesis, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/cts.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Глобальный буфер

+
+

Вы узнаетеЧто такое глобальный буфер, почему он живёт в собственной сети и как выглядела одна настоящая сборка всего потока.

Глобальный буфер, BUFG на кристалле 7-й серии, ведёт тактовый сигнал по выделенной малоперекосной сети, чтобы у дерева из прошлого урока был чистый корень. Виджет показывает поток, внутри которого стоит BUFG: одна настоящая сборка XC7A200T — 116,9 с с openXC7 и 83,5 с через путь t27 L3+L4, побайтово одинаковые битстримы, а разводка занимает 60 процентов времени. Буфер — один слой этой картины, а окно спеки снова открывает cts.t27, где строятся bufg() и тестируется bufg_has_higher_fanout().

Попробуйте

В виджете найдите два времени сборки и долю разводки в процентах; затем в окне спеки найдите bufg() и тест, дающий ей больший фан-аут.

+
tri game-selftest: the queen loop checks its own toolsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/cts.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Ловушка стробированного клока

+
+

Вы узнаетеПочему стробирование клока логикой создаёт новый домен и зачем нужен clock enable.

Стробировать клок логикой — элемент AND на линии тактового сигнала ради экономии — значит резать клок сигналом, который меняется со скоростью данных: получаются глитчи, и тихо возникает новый тактовый домен из всего, что ниже по потоку. Правило: не стробируйте клок; используйте clock enable — его сэмплирует триггер на фронте, а не фронт сэмплирует его. Виджет показывает дисциплину доказательства таких утверждений: два битстрима, различающихся в трёх битах, и выбивающая сборка на каждый бит, каждая снимает один — ни один бит не может приписать себе незаслуженную заслугу. Окно спеки открывает clock_domain.t27, чей тип источника gated_clk — модель этой ловушки.

Попробуйте

В виджете найдите, на сколько бит различаются битстримы и как снимали каждый; затем в окне спеки найдите тип источника gated-clock и значение перечисления стратегий, которое вынуждает стробированный клок.

+
Race the bee: who lands patches on t27, a person or a beeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/clock_domain.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · PLL и MMCM

Умножить и поделить один тактовый сигнал в другой, сдвинуть его фазу шагами VCO и какие тактовые сигналы анализатор считает родственными.

+
+
07

Урок 7 из 27

Умножить и поделить

+
+

Вы узнаетеКак MMCM превращает один тактовый сигнал в другой умножением и делением и в какие окна должны попасть числа.

MMCM превращает один тактовый сигнал в другой: вход делится на D, умножается на M во внутренний VCO, а VCO делится на O для выхода. mmcm.t27, написанная для этого курса, хранит M в восьмых долях, чтобы дробные шаги остались целыми: M от 2,000 до 64,000, D от 1 до 106, O от 1 до 128, и VCO обязан попасть в своё окно — здесь от 800 до 1600 МГц, учебное допущение, которое шапка помечает рядом с диапазонами из UG472. Со входа 200 МГц, M 5, D 1: VCO 1000 МГц, и O 10 даёт на выходе 100 МГц. Запись запускает нативный t27c: проходят 16 тестов, 4 инварианта comptime.

Попробуйте

В записи найдите конфигурацию на 500 МГц, которую называет тест-отказник; затем в окне спеки найдите, какие диапазоны шапка берёт из UG472, а какие помечены как допущения.

+
t27c on mmcm.t27 -- the MMCM model, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/mmcm.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Фаза и захват

+
+

Вы узнаетеНасколько мелкая ручка фазы, как ведёт себя модель захвата и что ломает одно расширенное окно.

Фаза движется шагами периода VCO, делённого на 56, — более быстрый VCO даёт более мелкую ручку, поэтому фазовой работе нужен высокий VCO. Захват смоделирован окном установления, которое шапка помечает как допущение. Запись расширяет это допущение одним sed: VCO_MIN_KHZ с 800000 до 400000. Конфигурация на 500 МГц, которую называет тест-отказник, въезжает внутрь расширенного окна, и падает ровно один тест, vco_below_the_window_is_rejected, — тест, называющий число, которое он отвергает, и есть тест, сторожащий допущение. Запись возвращает строку на место и печатает sha256 восстановленной спеки.

Попробуйте

В записи найдите строку sed, упавший тест и sha256 восстановленной спеки; затем в окне спеки вычислите шаг фазы для VCO 1000 МГц.

+
t27c on mmcm.t27 -- widen the VCO window, one test objectsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/mmcm.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Родственные или чужие

+
+

Вы узнаетеКогда анализатор проверяет путь между двумя тактовыми сигналами и когда ему надо сказать, что они чужие.

Два тактовых сигнала родственны, когда один сделан из другого — через MMCM из модуля 3 — и тогда каждый путь между ними хронометрируется: анализатор знает об общем происхождении. Чужим такая проверка не положена, пока вы её не объявите. timing.t27 — арифметика этой проверки: дуги, запас (slack) и Fmax с учебной моделью Artix-7: LUT 0,1 нс, BRAM 2,0 нс, DSP 2,5 нс, трассировка 0,3 нс. Запись запускает нативный t27c: проходят 25 тестов, 2 инварианта comptime. Родственные клоки были модулем 3; безопасность чужих — это модули с 5 по 7.

Попробуйте

В записи посчитайте прошедшие тесты; затем в окне спеки найдите четыре учебные задержки шапки и функцию, превращающую дуги в запас.

+
t27c on timing.t27 -- static timing, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/timing.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Сбросы

Ассертировать асинхронно, снимать синхронно: три вида сброса, конвейер снятия и дерево, которое растит сброс.

+
+
10

Урок 10 из 27

Синхронный или асинхронный

+
+

Вы узнаетеТри вида сброса, какой из них гонится с клоком и какую форму рекомендует курс.

Плата нажимает сброс, когда хочет, а не когда скажет ваш клок: ассерт может быть асинхронным. Снятие — не может. reset_sync.t27, написанная для этого курса, называет три вида: sync (0), где ассерт и снятие идут через клок; async assert, sync release (1), обычный выбор; и async assert, async release (2), который гонится с recovery и removal на каждом триггере, что он питает. is_recommended() принимает виды 0 и 1 минимум с 2 ступенями. Запись запускает нативный t27c: проходят 16 тестов, 3 инварианта comptime.

Попробуйте

В записи найдите тест, называющий асинхронное снятие гонкой; затем в окне спеки прочитайте is_recommended() и проверьте, что она требует от вида и числа ступеней.

+
t27c on reset_sync.t27 -- the reset kinds, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/reset_sync.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Конвейер снятия

+
+

Вы узнаетеКак снятие сброса проходит по сдвиговому регистру и что компилятор для него генерирует.

Снятие идёт по сдвиговому регистру: на такте приёмника триггер за триггером берёт значение соседа, и сброс держится, пока конвейер не опустеет. Задержка равна числу ступеней — 2 ступени снимаются за 2 такта, 3 за 3. Запись показывает, что компилятор генерирует для модели: t27c gen печатает Zig, и функция step — это копирование структуры, по одному полю на триггер, и ничего больше. wc -l в конце записи — размер всей сгенерированной модели.

Попробуйте

В записи найдите число из wc -l; затем в окне спеки найдите after_clocks() и проверьте, что задержка снятия равна числу ступеней.

+
t27c gen on reset_sync.t27 -- the release pipe as ZigВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/reset_sync.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Разветвление сброса

+
+

Вы узнаетеПочему сброс растит дерево, как тактовое, и где его цена видна в настоящем подсчёте ресурсов.

Сброс доходит до каждого триггера дизайна, поэтому он растит дерево, как тактовое, и балансируется по той же причине: неровное снятие — это перекос, который вы построили сами. Виджет считает настоящую разведённую схему против собственных итогов XC7A200T, прочитанных из chipdb и prjxray-db, и посчитает вашу, если бросить её разведённый JSON. Дерево сброса живёт в том же бюджете: трассировка и давление control set, видимые ровно в этих столбиках. Окно спеки снова открывает cts.t27 — арифметику дерева, общую для обоих деревьев.

Попробуйте

В виджете прочитайте итоги, против которых считаются столбики; затем в окне спеки найдите целевой перекос, под который балансируется и дерево сброса.

+
tri fpga-rxcapВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/cts.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Метастабильность

Окно setup-hold, среднее время между отказами в целочисленной арифметике и два триггера, которые это чинят.

+
+
13

Урок 13 из 27

Окно setup-hold

+
+

Вы узнаетеЧто значат setup и hold, что делает триггер при попадании в окно и что показывает из этого VCD.

У каждого триггера есть окно вокруг снимающего фронта — setup до него, hold после. Попади переход внутрь окна — и триггер не выберет уровень чисто: выход может зависнуть между 0 и 1, метастабильное состояние, разрешающееся во времени, которого datasheet не обещает. Виджет читает .vcd из любого симулятора и сообщает смены значений, самый загруженный сигнал и сигналы, застрявшие в X или Z: X в симуляции — способ тестбенча показать, что окно нарушено. Окно спеки открывает clock_domain.t27, чью модель пересечения модуль 5 превращает в арифметику.

Попробуйте

В виджете бросьте .vcd, если он у вас есть, и найдите самый загруженный сигнал; затем в окне спеки найдите модель пересечения, которой принадлежит окно.

+
tri fpga-rxerВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/clock_domain.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Среднее время между отказами

+
+

Вы узнаетеКак MTBF назначает пересечению цену в целочисленной арифметике log2 и какие константы в ней допущения.

MTBF назначает пересечению цену: e^(T/tau), делённое на F_clk, F_data и окно W, — форма, которой учит Xilinx WP323. mtbf.t27, написанная для этого курса, считает её в целочисленном log2 с 10 дробными битами, потому что честный ответ переполняет любой целочисленный счёт секунд. tau 50 пс и W 10 пс помечены как допущения: вендоры публикуют параметры триггеров лишь частично. На приёме 100 МГц потока 10 МГц 1 ступень оставляет -200 пс запаса и Q10 log2-MTBF -19513 — меньше двух микросекунд; 2 ступени оставляют 9800 пс и 275887 — дольше любых часов, которые вселенная успеет протикать. Запись запускает нативный t27c: проходят 15 тестов, 4 инварианта comptime.

Попробуйте

В записи найдите grep, перечисляющий допущения; затем в окне спеки посчитайте, что сулит stage_gain_q10() на 100 МГц за ещё один триггер.

+
t27c on mtbf.t27 -- MTBF in integer log2, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/mtbf.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Двухтриггерный синхронизатор

+
+

Вы узнаетеПочему два триггера — это лекарство и как выглядит сгенерированная модель пересечения.

Лекарство — два триггера на такте приёмника, между ними ничего: ведущий может уйти в метастабильность, а второй снимает его устоявшийся выход целый период спустя. Каждая дополнительная ступень умножает MTBF на 2 в степени T_clk, умноженное на log2 e и делённое на tau, — 295400 в Q10 на 100 МГц, это stage_gain_q10() спеки. Запись показывает t27c gen на clock_domain.t27: напечатанный Zig — модель пересечения, на которую опирается весь курс, и wc -l её считает. Цена двух триггеров — задержка: пара тактов приёмника от фронта до устоявшегося выхода, та же цена, которую платит конвейер снятия из модуля 4.

Попробуйте

В записи найдите wc -l сгенерированной модели; затем в окне спеки найдите стратегию two_flop и скажите, какой модуль её разбирал.

+
t27c gen on clock_domain.t27 -- the CDC model as ZigВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/clock_domain.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Пересечение многих бит

Почему двоичная шина рвётся, почему код Грея нет, и рукопожатие, переносящее импульс между мирами.

+
+
16

Урок 16 из 27

Почему двоичный код рвётся

+
+

Вы узнаетеПочему сэмплирование двоичной шины в другом домене рвёт её и что спека FIFO проверяет у указателей.

Пересеките многобитную шину сэмплированием в другом домене — и она порвётся: часть бит придёт от старого значения, часть от нового, и прочитанного значения никогда не существовало. Двоичный счётчик — худший носитель: с 7 на 8 переворачиваются сразу четыре бита. fifo.t27 — буфер, который делает это правильно, его голова движется как (head_ptr + 1) % depth, а MAX_FIFO_DEPTH равен 65536. Запись запускает нативный t27c на нём: проходят 18 тестов, 6 инвариантов comptime. Тесты проверяют счётчики заполнения и флаги; следующий урок показывает, чего они не проверяют никогда.

Попробуйте

В записи посчитайте прошедшие тесты и доказанные инварианты; затем в окне спеки найдите обновление указателя головы и константу максимальной глубины.

+
t27c on fifo.t27 -- the FIFO stdlib, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/fifo.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Код Грея

+
+

Вы узнаетеПочему код Грея меняет по одному биту за шаг и чего не может увидеть набор тестов, не читающий указатели.

Код Грея меняет ровно один бит за шаг, поэтому сэмпл, взятый посреди изменения, даёт один из двух соседних кодов — ошибку на единицу, но не мусор. FIFO, чьи указатели чтения и записи считают по Грею, можно безопасно сэмплировать через домены, и выводимые из них флаги держатся. Запись подкладывает мутацию, которую Грей поймал бы с поличным, если бы тесты смотрели: (state.head_ptr + 1) превращается в + 3, и все тесты по-прежнему проходят, потому что набор утверждает заполнение и флаги, но никогда значения указателей. Набор тестов защищает то, что он читает; кодировку защищает правило следующего урока, а не эти тесты. Запись восстанавливает спеку и печатает её sha256.

Попробуйте

В записи найдите строку sed и убедитесь, что ни один тест не упал; затем в окне спеки найдите утверждения о заполнении и флагах и укажите дыру, в которую проскользнула мутация.

+
t27c on fifo.t27 -- a pointer mutation the tests cannot seeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/fifo.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Рукопожатия и импульсы

+
+

Вы узнаетеКак рукопожатие переносит импульс между мирами и что общего у отчёта по фронтам и тоггл-синхронизатора.

Импульс перенести труднее всего: один такт здесь — не один такт там. Рукопожатие превращает его в уровень: сторона отправителя поднимает запрос, приёмник его сэмплирует, поднимает подтверждение, и запрос падает — четыре фронта, и импульс стал разговором. Виджет — отчёт, работающий так же: 25 живых проверок, печатающий только строки NEW red или CLEARED с прошлого взгляда — дальняя сторона видит изменение, а не уровень, ровно то, что тоггл-синхронизатор устраивает в железе. Окно спеки открывает clock_domain.t27, чья стратегия handshake — этот разговор в виде одного значения перечисления.

Попробуйте

В виджете найдите, сколько проверок ведёт отчёт и что он печатает, когда ничего не изменилось; затем в окне спеки найдите стратегию handshake и посчитайте фронты её разговора.

+
tri game-tick: one anomaly scan, only what changedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/clock_domain.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Асинхронный FIFO

Указатели, флаги и глубина: буфер, переносящий поток между двумя тактовыми сигналами.

+
+
19

Урок 19 из 27

Указатели и флаги

+
+

Вы узнаетеКак флаги выводятся из указателей, какие сигналы на самом деле пересекают границу и что ломает одно переприсваивание.

Данные не пересекают границу: они живут в BRAM, и обе стороны адресуют их. Пересекают указатели — по Грею — и флаги, выведенные из них: пусто, когда указатели равны, полно, когда они различаются на глубину. Запись ломает арифметику флагов одним переприсваиванием — push ставит flags.empty в true — и падает ровно один тест, push_increments_fill, который просит у push непустой FIFO. Запись восстанавливает спеку и печатает её sha256. Окно спеки открывает fifo.t27, где push и pop строят флаги, несомые через границу.

Попробуйте

В записи найдите переприсваивание и ровно один упавший тест; затем в окне спеки найдите, где push строит флаги, и выведите пусто из указателей сами.

+
t27c on fifo.t27 -- break a flag, one test objectsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/fifo.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Выбор глубины

+
+

Вы узнаетеКак глубина следует из скорости записи, скорости чтения и худшей пачки и что измеряет настоящий хронометрированный цикл.

Глубина — не чувство: запись идёт со скоростью W, чтение со скоростью R, и буфер должен вместить худшую пачку, умноженную на (W - R), за время её длительности. Переразмеренный — тратит BRAM, который можно было потратить иначе; недоразмеренный — переполняется молча, потому что полный FIFO теряет или блокирует, и ни то, ни другое не видно на волновой диаграмме. Виджет — настоящий цикл с измеренным временем: 19,06 с на router1, bitwalk, xc7frames2bit и загрузку SRAM на ноутбуке при load average около 110 — та же арифметика скорости и времени, которая выбирает размер буфера, измеренная на запуске, который был на самом деле. Окно спеки открывает fifo.t27, чей fill_count — то самое число.

Попробуйте

В виджете найдите измеренное время цикла и load average, при котором он шёл; затем в окне спеки найдите fill_count и напишите формулу глубины для своей худшей пачки.

+
tri competitors audit: the table, auditedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/fifo.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

Тестбенч FIFO

+
+

Вы узнаетеКак выглядит настоящая дисциплина тестбенча и почему этот урок открывает спеку FIFO и запись мутаций.

Тестбенч асинхронного FIFO гнал бы оба клока, рвал бы указатели нарочно и проверял бы, что флаги не врут. Спека тестбенча в этом дереве — пока не то: она не компилируется браузерным компилятором, а нативные запуски на ней заблокированы, поэтому урок открывает сам fifo.t27, а вместо тестбенча FIFO — запись дисциплины, которой он следовал бы: 5 подложенных багов в packets.t27 — бит полинома CRC, ширина адреса CRC, пустые операции LFRM, бит COR0 и длина слова type-2 — каждая мутация пересобирается и перепрогоняется, и каждая поймана. Когда появится настоящая спека тестбенча, урок возьмёт её.

Попробуйте

В записи перечислите 5 подложенных багов и посчитайте, сколько поймано; затем в окне спеки найдите флаги, которые настоящему тестбенчу пришлось бы рвать нарочно.

+
tri discard top: what the parser throws awayВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/fifo.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Ограничения

Строки, сообщающие анализатору, что такое тактовый сигнал, какие пути не проверять и чему должны соответствовать выводы.

+
+
22

Урок 22 из 27

Строка create_clock

+
+

Вы узнаетеЧто строка create_clock сообщает анализатору и какая спека её пишет.

Пока строки create_clock нет, анализатор не видит клока вовсе и ничего не хронометрирует: каждый путь без ограничений, каждый отчёт пуст. Строка называет порт, период и фронты формы волны. emitter_xdc.t27 — спека эмиттера, который пишет такие строки из спеки выводов, — её текст несёт create_clock -add -name среди строк, которые она выпускает. Нативный test-report на этой спеке в текущем дереве заблокирован, поэтому запись показывает то, что работает: t27c parse спеки, чисто, и grep, находящий её строки create_clock. Плеер компилирует спеку в браузере.

Попробуйте

В записи найдите строки create_clock, которые возвращает grep; затем в окне спеки найдите построитель строк эмиттера и скажите, чего нехватка create_clock делает с отчётом тайминга.

+
t27c on emitter_xdc.t27 -- the XDC emitter, parsedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/pins/emitter_xdc.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

False path и max delay

+
+

Вы узнаетеЧто объявляет false path, что вместо этого ограничивает max delay и как выглядит удаление проверки в репозитории.

set_false_path сообщает анализатору, что переход асинхронный: не докладывай о нём, им владеет синхронизатор. За пределами этого он глушит настоящие отказы, поэтому поток CDC ставит рядом set_max_delay, который ограничивает путь синхронизатора вместо игнорирования — те два-три триггера всё равно должны быть близки по времени. False path — это проверка, убранная нарочно, и виджет показывает, как выглядит удаление проверок в репозитории: 14 дней слитых пул-реквестов, кто добавил тесты, кто поменял, кто снял ассерты, с точными строками из git. Окно спеки открывает timing.t27 — анализ, в котором исключения вырезают дыры.

Попробуйте

В виджете найдите пул-реквест, снявший ассерты, и строки, которые он забрал; затем в окне спеки найдите арифметику запаса, которую глушит false path.

+
tri fpga-txhold: setup and hold from the routed SDFВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/timing.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Тайминг выводов

+
+

Вы узнаетеКак тайминг выводов задаётся против клока, которым управляет другая микросхема, и как выглядят запасы, прочитанные из SDF.

Тайминг вывода задаётся против клока, которым ведёт другая микросхема: set_input_delay и set_output_delay, отрицательные до фронта, положительные после. Виджет показывает, как выглядят такие запасы, когда их читают, а не предполагают: два записанных прогона модели по разведённому дизайну E3 для платы AX7203 (XC7A200T в корпусе FBG484), напечатанные — минимальный TX hold 3445 пс на eth_txd[1], минимальный RX-запас между полубайтами 10900 пс на rxctl_n, оба PASS — модель по собственному SDF nextpnr о разведённом дизайне, а не измерение на плате, и она так и говорит. Окно спеки снова открывает emitter_xdc.t27, эмиттер, куда эти строки пошли бы.

Попробуйте

В виджете найдите минимальный TX hold и вывод, на котором он измерен; затем в окне спеки найдите, куда эмиттер поставил бы input- и output-задержки.

+
tri fpga-txhold · RGMII margins from nextpnr's own SDFВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/pins/emitter_xdc.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · На плате

Отчёт CDC, одно пересечение, захваченное на триггерах, и дифф битстрима, замыкающий курс.

+
+
25

Урок 25 из 27

Отчёт CDC

+
+

Вы узнаетеЧто перечисляет отчёт CDC и о чём спрашивает каждое пересечение, и что общего у него с отчётом проверенных вещей.

Отчёт CDC проходит по каждому пересечению нетлиста и спрашивает: синхронизировано, и насколько? Он называет несинхронизированные пути, синхронизаторы со слишком малым числом ступеней, шины, забывшие свой Грей. Виджет — другой отчёт из названных вещей, каждая проверена: 129 файлов целы против новейшего из 54 снимков с адресацией по содержимому — не отчёт CDC, но та же форма: список, где каждая строка — вердикт с источником. Окно спеки открывает timing.t27, арифметику, на которую такой отчёт опирается, оценивая надёжность синхронизатора.

Попробуйте

В виджете найдите, сколько файлов отчёт держит целыми и против скольких снимков он проверяет; затем в окне спеки найдите оценку, которую отчёт CDC прогонял бы по каждому пересечению.

+
tri game-vault: the loop's skills checked against snapshotsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/timing.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Захватить пересечение

+
+

Вы узнаетеКак захватили одно пересечение в точке, где оно приземляется: на самих RX-приёмных триггерах, и что напечатал записанный запуск.

Одно пересечение, захваченное там, где оно приземляется: на самих RX-приёмных триггерах. Команда tri fpga-rxcap моделирует захват E3 RX на плате AX7203 (XC7A200T в корпусе FBG484) в том же SDF, что и прошлый модуль, и её записанный запуск напечатал: hold по спадающему фронту 10900 пс на rxctl_n, при RXC на 2,4 нс позади своих данных через BUFG, так что rxd_p1 и полубайт RX_ER снимают новое значение в окне, которое модель называет. Спека — карточка инструмента: константы для страницы инструмента, 0 тестов, и запись показывает, как нативный отчёт говорит именно это. Выводы, которые она захватывает, — дальний конец каждого урока перед этим.

Попробуйте

В записи найдите записанный запас hold и задержку через BUFG; затем в окне спеки прочитайте источники данных карточки и скажите, чего модель не измеряла.

+
t27c on fpga-rxcap.t27 -- the RX capture card, nativeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/fpga-rxcap.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Капстоун: поменяй и сравни

+
+

Вы узнаетеКак куски курса сходятся в одной сборке и что говорит дифф битстрима об изменении.

Замкните круг: поменяйте в пересечении одну вещь — ступень синхронизатора, указатель Грея, ограничение — пересоберите и спросите битстрим, что сдвинулось. Виджет сравнивает два битстрима Xilinx 7-й серии в браузере: заголовок, пакеты и каждый кадр из 101 слова, с декодированным адресом отличающегося кадра; ничего не загружается наружу. Изменение CDC, утверждающее, что оно ничего не меняет, должно давать пустой дифф, а осмысленное — показывает, какие кадры оно задело. Окно спеки открывает fifo.t27, буфер, который этот курс построил пересечение за пересечением, и его 18 прошедших тестов — квитанция.

Попробуйте

В виджете бросьте два битстрима, если они есть, и найдите отличающийся кадр; затем в окне спеки выберите один тест FIFO и скажите, какое изменение его сломало бы.

+
tri blog list: every t27.ai post and its receipt stateВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/fifo.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Что такое тактовый сигнал
    1. 01 Один фронт, один мир
    2. 02 Период, фронт и джиттер
    3. 03 Где входит тактовый сигнал
  2. 02 · Деревья тактового сигнала
    1. 04 Перекос и задержка прохождения
    2. 05 Глобальный буфер
    3. 06 Ловушка стробированного клока
  3. 03 · PLL и MMCM
    1. 07 Умножить и поделить
    2. 08 Фаза и захват
    3. 09 Родственные или чужие
  4. 04 · Сбросы
    1. 10 Синхронный или асинхронный
    2. 11 Конвейер снятия
    3. 12 Разветвление сброса
  5. 05 · Метастабильность
    1. 13 Окно setup-hold
    2. 14 Среднее время между отказами
    3. 15 Двухтриггерный синхронизатор
  6. 06 · Пересечение многих бит
    1. 16 Почему двоичный код рвётся
    2. 17 Код Грея
    3. 18 Рукопожатия и импульсы
  7. 07 · Асинхронный FIFO
    1. 19 Указатели и флаги
    2. 20 Выбор глубины
    3. 21 Тестбенч FIFO
  8. 08 · Ограничения
    1. 22 Строка create_clock
    2. 23 False path и max delay
    3. 24 Тайминг выводов
  9. 09 · На плате
    1. 25 Отчёт CDC
    2. 26 Захватить пересечение
    3. 27 Капстоун: поменяй и сравни
+ + + + + diff --git a/apps/website/public/ru/learn/clocks-and-cdc/index.html b/apps/website/public/ru/learn/clocks-and-cdc/index.html index b2bc6e7baf..5208553dec 100644 --- a/apps/website/public/ru/learn/clocks-and-cdc/index.html +++ b/apps/website/public/ru/learn/clocks-and-cdc/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

Тактирование, сброс и пересечения тактовых доменов на t27

Он продолжает курс по ИИ-числам с того места, где тот заканчивается. Каждый урок открывает настоящий инструмент или запись t27c на настоящей машине рядом со спекой, которую можно запустить в браузере.

Курс 3, 27 уроков, в каждом виджет и спека t27: что такое тактовый сигнал и где он входит в плату, дерево тактового сигнала, MMCM, три вида сброса, метастабильность и MTBF, пересечение многих бит, асинхронный FIFO, файл ограничений и чтение пересечений на реальном железе. Каждое число взято из спеки или из записанного запуска.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/comments-and-prose/index.html b/apps/website/public/ru/learn/comments-and-prose/index.html index 389fae8641..f3544f6740 100644 --- a/apps/website/public/ru/learn/comments-and-prose/index.html +++ b/apps/website/public/ru/learn/comments-and-prose/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Комментарии и строки прозы

Вы узнаете

Где может стоять каждый вид заметки и какая строка ломает парсер.

Строка, которая начинается с точки с запятой, — это проза: компилятор пропускает её до конца. Строки прозы стоят на верхнем уровне, между объявлениями. Две косые черты начинают комментарий где угодно: после кода или внутри теста. Ловушка: точка с запятой одна на строке — это не пустая строка прозы, а ошибка разбора, и падает вся спека. Поставьте после неё слово или оставьте строку пустой.

Попробуйте

Добавьте в спеку урока в плеере строку с одной точкой с запятой, прочитайте ошибку и уберите её.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 3: where comments may stand
t27 basics 3: where comments may stand ↗

Prose lines, slash comments and the lone semicolon that breaks a t27 spec, each checked with the real compiler. Lesson 3 of the t27 basics course.

specs/basics/03_comments_and_prose.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

Комментарии и строки прозы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/compare-at-the-top/index.html b/apps/website/public/ru/learn/compare-at-the-top/index.html index 92ead28354..33a8b4b21c 100644 --- a/apps/website/public/ru/learn/compare-at-the-top/index.html +++ b/apps/website/public/ru/learn/compare-at-the-top/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сравнение сверху

Вы узнаете

Почему числа в сбалансированной троичной сравниваются по первому различному триту.

В сбалансированной троичной триты ниже разряда i в сумме дают меньше половины 3^i, поэтому любое сравнение решает старший различный трит. 41 — это +----, а 39 — 0+++0: они различаются в старшем трите, значит 41 больше, хотя на его плитках четыре минуса. compare() спеки читает этот трит и сверяется с обычными «меньше» и «больше» на 714 парах.

Попробовать

Найдите два числа, которые впервые различаются в младшем трите, и два, которые различаются в каждом трите.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Compare at the first differing trit
Compare at the first differing trit ↗

Two numbers line up trit by trit; the first place from the top where they differ decides. The answer is itself a trit.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Сравнение сверху

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/compare-traces/index.html b/apps/website/public/ru/learn/compare-traces/index.html index d9af2b87f9..62fd651646 100644 --- a/apps/website/public/ru/learn/compare-traces/index.html +++ b/apps/website/public/ru/learn/compare-traces/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сравнение двух трасс

Вы научитесь

Как сравнить два прогона и пусть трасса назовёт самый ранний такт расхождения.

Два прогона одного тестбенча, до изменения и после: самый быстрый вопрос — где они разошлись. Диф по трассе отвечает с точностью до одного изменения сигнала: самый ранний такт, где эталонный прогон говорит 1, а новый говорит 0. Виджет сравнивает файлы именно так, кадр за кадром, и отказывается говорить «одинаково», когда байт различается. Spec урока — тестбенч, ведущий инструмент сравнения VCD: ожидание против факта, с печатью несовпадения, а не разглядыванием.

Попробуйте

Откройте диф на двух собственных файлах; затем найдите в тестбенче сравнения место, где печатается самый ранний несовпадающий такт.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Bitstream diff: two 7-series .bit files, frame by frame
Bitstream diff: two 7-series .bit files, frame by frame ↗

Drop two Xilinx 7-series bitstreams: header, packets and every 101-word frame compared in your browser, the first differing frame address decoded. Nothing is uploaded.

specs/fpga/testbench/vcd_conformance_compare_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -179,6 +211,7 @@ 

Сравнение двух трасс

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/compiler-stages/index.html b/apps/website/public/ru/learn/compiler-stages/index.html index 4ac2f59bce..b13ef15d5f 100644 --- a/apps/website/public/ru/learn/compiler-stages/index.html +++ b/apps/website/public/ru/learn/compiler-stages/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Стадии t27c

Вы узнаете

Путь спеки внутри t27c: токены, синтаксическое дерево, типы, HIR, код.

t27c читает спеку по стадиям. Лексер режет текст на токены. Парсер строит синтаксическое дерево. Проверка типов проверяет каждую ширину и каждый вызов. Дерево опускается в HIR, более простую форму, и каждый бэкенд пишет код из неё. Этот виджет прогоняет стадии на спеке в вашем браузере и показывает, что выдала каждая, так что у ошибки есть стадия, на которую можно указать.

Попробуйте

Выберите пример и пройдите по стадиям; найдите стадию, на которой остановилась бы ошибка типов.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Inside t27c: watch a compiler read your code, stage by stage
Inside t27c: watch a compiler read your code, stage by stage ↗

Edit a small t27 spec and see what the real t27c compiler, running as WebAssembly in your tab, makes of it: tokens, tree, type check, HIR and code in seven languages.

specs/tutorial/06_structs_enums_switch.t27

// SPDX-License-Identifier: Apache-2.0
@@ -208,6 +240,7 @@ 

Стадии t27c

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/compiles-is-not-correct/index.html b/apps/website/public/ru/learn/compiles-is-not-correct/index.html index 6bcebcfc17..198e012788 100644 --- a/apps/website/public/ru/learn/compiles-is-not-correct/index.html +++ b/apps/website/public/ru/learn/compiles-is-not-correct/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Компилируется — не значит верно

Вы узнаете

Почему зелёные галочки — не доказательство и как поймать код, который компилируется и неверен.

Компилятор, принявший ваш код, говорит только, что код правильно оформлен. Он не говорит, что код значит то, что вы имели в виду. Эта запись показывает инструмент, нашедший спеки, которые компилируются, проходят все проверки и всё равно прочитаны неправильно. Для железа урок ещё жёстче: ошибку в кремнии не исправить патчем. Внесите ошибку сами в записи с мутациями и посмотрите, как тесты её ловят.

Попробуйте

Откройте запись с мутациями в «Ещё попробуйте» и посчитайте, сколько подложенных ошибок поймали тесты.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri misread: code that compiles and is wrong
tri misread: code that compiles and is wrong ↗

1,144 of 1,156 specs generate; 41 spec-shape pairs are read wrongly with every gate green.

specs/tutorial/03_operators.t27

// SPDX-License-Identifier: Apache-2.0
@@ -177,6 +209,7 @@ 

Компилируется — не значит верно

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/consensus-and-any/index.html b/apps/website/public/ru/learn/consensus-and-any/index.html index d73d66eef6..749b7f2bfd 100644 --- a/apps/website/public/ru/learn/consensus-and-any/index.html +++ b/apps/website/public/ru/learn/consensus-and-any/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Консенсус и «любой»

Вы узнаете

Два вентиля, которые имеют смысл только при трёх значениях.

CONSENSUS сохраняет значение, в котором сходятся оба входа, а иначе отвечает «не знаю»; ANY берёт тот вход, который определён, и отвечает «не знаю», только когда входы противоречат друг другу. При двух значениях ни у одного из них нет пары, и это одна из причин, почему у двухвходового троичного вентиля 19683 возможные таблицы. Оба — тела fn из trits.t27, проверенные на парах входов, которые их различают.

Попробовать

Найдите входы, где CONSENSUS и ANY отвечают по-разному, и придумайте задачу с датчиками, где каждый из них был бы верным выбором.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Consensus and any: gates binary logic does not have
Consensus and any: gates binary logic does not have ↗

Consensus keeps a value both inputs agree on; any keeps the decided input when the other is unknown. Neither exists with two values.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Консенсус и «любой»

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/constants/index.html b/apps/website/public/ru/learn/constants/index.html index 2db59d8ba4..0ca01847cb 100644 --- a/apps/website/public/ru/learn/constants/index.html +++ b/apps/website/public/ru/learn/constants/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Константы

Вы узнаете

Шесть частей объявления константы и что делает каждая.

pub const WIDTH : u8 = 8; читается слева направо: pub делает имя видимым другим модулям, const говорит, что значение неизменно, WIDTH — имя, u8 — тип, 8 — значение, точка с запятой завершает строку. Константы — то, что умеет проверять тестовый прогон этого сайта: спека урока объявляет WIDTH, HEIGHT и AREA и проверяет, что 8 на 4 даёт 32.

Попробуйте

Поменяйте AREA в спеке урока на 33 и посмотрите, какой тест упадёт.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 4: a constant, piece by piece
t27 basics 4: a constant, piece by piece ↗

The six pieces of a t27 constant declaration in one table. Lesson 4 of the t27 basics course.

specs/basics/04_constants.t27

// SPDX-License-Identifier: Apache-2.0
@@ -81,6 +113,7 @@ 

Константы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/count-the-cells/index.html b/apps/website/public/ru/learn/count-the-cells/index.html index 8220e46144..8fd63fc892 100644 --- a/apps/website/public/ru/learn/count-the-cells/index.html +++ b/apps/website/public/ru/learn/count-the-cells/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Посчитайте ячейки

Вы узнаете

Как посчитать, что построил синтезатор: LUT, триггеры, DSP, блочную память.

После синтеза yosys может напечатать построенное в JSON: сколько LUT, триггеров, DSP и блоков памяти. Эти числа — честная мера дизайна до размещения и трассировки. Вставьте stat -json из yosys в карточку или откройте настоящий пример и получите карточку и бейдж для README, которые прямо говорят, что это подсчёт синтеза.

Попробуйте

Откройте настоящий пример и прочитайте на карточке число LUT и FF.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Stat card: your yosys stat -json as a card and a README badge
Stat card: your yosys stat -json as a card and a README badge ↗

Paste yosys stat -json: LUT, FF, DSP and BRAM counts, the top module and the yosys version on a 1200x630 card plus a README badge SVG. Read in your browser.

specs/tutorial/04_control_flow.t27

// SPDX-License-Identifier: Apache-2.0
@@ -220,6 +252,7 @@ 

Посчитайте ячейки

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/course/all/card.png b/apps/website/public/ru/learn/course/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..885b6cf13916837c725bbcecf445ef41d4c00e73 GIT binary patch literal 42863 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 H;1csM19* + + + + + +С нуля до чипа: программирование FPGA на t27: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

С нуля до чипа: программирование FPGA на t27

+

Опыт с железом не нужен. Каждый урок открывает настоящий инструмент, собранный из реальных запусков на нашем стенде: прочитайте немного и попробуйте сами.

+

27 уроков, в каждом рабочий виджет и спека t27: что такое FPGA, как числа становятся битами, ваша спека на t27, как её компилирует t27c и как она превращается в битстрим на настоящей плате.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

Пройдено 0 из 27

+

Открыть интерактивный курс →

+
+

Модуль 1 · Чип

Что такое FPGA, какой чип у нас и как его выводы встречаются с платой.

+
+
01

Урок 1 из 27

FPGA — это сетка, которую вы настраиваете

+
+

Вы узнаетеИз чего состоит FPGA и почему дизайн занимает только часть чипа.

Процессор выполняет инструкции одну за другой. У FPGA программы нет вовсе: это сетка маленьких блоков — таблиц истинности (LUT), триггеров, цепочек переноса, блочной памяти и DSP-умножителей, — соединённых проводами, которые можно переключать. Настроив сетку, вы строите схему. Чип нашего стенда — AMD Artix-7 XC7A200T. Skyline рисует один оттрассированный дизайн на этом кристалле: каждый настроенный тайл встаёт столбиком, а большая часть чипа остаётся тёмной.

Попробуйте

Поверните кристалл и нажмите на самый высокий столбик: какой тип тайла задаёт больше всего фич? В спеке платы нашего стенда найдите LUT_TOTAL, затем инвариант про DSP48E1_TOTAL: что, судя по его имени, используют наши ядра?

+
FASM skyline: a routed 7-series design as a city on the XC7A200T dieВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/boards/wukong_v1.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Какой это чип?

+
+

Вы узнаетеКак чип называет себя в 32 битах и как эти биты читать.

Прежде чем что-то загружать, спросите плату, какой на ней чип. По JTAG каждый чип отвечает 32-битным IDCODE: версия, номер детали, производитель и постоянная 1 в бите 0. Битстрим, собранный для другой детали, чип отвергнет, так что эта проверка экономит вам полдня. Декодер делит биты на эти четыре поля и ищет деталь в таблице самого openFPGALoader.

Попробуйте

Нажмите пресет стенда, затем переверните один бит номера детали и посмотрите, какое это было бы устройство. В спеке действие idcode-cfg называет IDCODE, который возвращает исправный XC7A100T: раскодируйте его и сравните номер детали с чипом стенда.

+
JTAG IDCODE decoder: 32 bits, four fields, one deviceВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/tri/fpga.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Выводы, шарики и корпус

+
+

Вы узнаетеКак сигналы вашего дизайна попадают во внешний мир.

Чип сидит в корпусе: у XC7A200T на нашей плате под ним 676 шариков припоя. Часть несёт питание или конфигурацию, и только часть — пользовательский ввод-вывод, сгруппированный в банки со своим напряжением. Файл ограничений (XDC) говорит, какой шарик использует каждый сигнал дизайна. Поставьте сигнал на шарик, который не является пользовательским IO, и сборка упадёт или, хуже, плата будет делать не то, что вы думаете.

Попробуйте

Найдите шарик по имени, например E3, затем раскрасьте по типу вывода и найдите шарик, который не является пользовательским IO. Спека ставит небольшой дизайн на другой корпус, XC7A100T в CSG324: найдите тест, который сажает такт на шарик E3, и тест, который считает выводы.

+
Pin map: the XC7A200T FGG676 package ball by ball, with an XDC lintВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/boards/xc7a100t_minimal.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Числа в железе

Биты, триты и форматы чисел, и сколько стоит арифметика в логике.

+
+
04

Урок 4 из 27

Биты, триты и GF16

+
+

Вы узнаетеКак число хранится в битах и как сбалансированная троичная система хранит его в тритах.

Железо хранит числа как группы битов фиксированной длины, и t27 заставляет писать ширину: u8 — это 8 беззнаковых битов, i16 — 16 битов со знаком. t27 также говорит на сбалансированной троичной системе, где трит равен -1, 0 или +1. Для дробей есть GF16, 16-битное число с плавающей точкой: 1 бит знака, 6 битов экспоненты и 9 битов мантиссы. Введите число в калькулятор и посмотрите, как оно округляется, поле за полем, и насколько велика ошибка.

Попробуйте

Введите 1.618 и прочитайте биты экспоненты и мантиссы; затем введите 0.1 и посмотрите на ошибку.

+
GF16 calculator: a number as 16 GoldenFloat bits and as ternaryВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tutorial/01_values_and_types.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Сколько стоит арифметика

+
+

Вы узнаетеПочему умножитель дорогой, а сумматор дешёвый, — по измерениям на настоящем чипе.

В логике у каждой операции есть цена, которую платят ресурсами чипа. Сумматор — это цепочка переноса, дешёвая и быстрая. Умножитель из LUT огромен; на чипе есть DSP-блоки, сделанные для умножения, и синтезатор использует их, когда ему можно. Эти кривые — настоящие подсчёты yosys от 4 до 64 битов. Выключите и включите DSP и увидите, почему в железе так заботятся о ширине каждого числа.

Попробуйте

Выберите Multiply, переключите DSP48E1 на -nodsp и сравните LUT на 32 битах с DSP и без них.

+
Cost curves: adders, multipliers and MACs on a Xilinx 7-seriesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tutorial/05_widths_and_casts.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Сколько помещается на чип

+
+

Вы узнаетеКак читать подсчёт ресурсов и находить, какой ресурс кончится раньше.

Отчёт синтеза говорит, сколько LUT, триггеров, DSP и блоков памяти занимает дизайн. Важный вопрос — какой из них кончится раньше. Дизайн может занимать мало LUT и всё равно не влезть, потому что ему нужно больше DSP, чем есть на чипе. Введите число LUT или выберите один из наших настоящих дизайнов и посмотрите, сколько копий влезет в XC7A200T.

Попробуйте

Выберите настоящий дизайн, затем увеличивайте число DSP, пока раньше LUT не кончится что-то другое. В спеке fits_board проверяет четыре ресурса по очереди: какой идёт последним и сколько блоков DSP48 перечисляет xc7a100t_resources?

+
Fits on a 200T: how many copies of your design an XC7A200T holdsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/stdlib.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Ваша программа на t27

Напишите спеку, проверьте её и увидьте, почему «компилируется» не значит «верно».

+
+
07

Урок 7 из 27

Привет, t27

+
+

Вы узнаетеКак выглядит спека t27 и что с ней делает компилятор прямо в вашем браузере.

Программа на t27 — это спека: модуль с типизированными константами, функциями и тестами. Строки прозы начинаются с точки с запятой в начале строки. Плеер ниже запускает настоящий компилятор t27, собранный в WebAssembly, внутри вашего браузера: он читает hello_world.t27, прогоняет его тесты и пишет код для семи бэкендов. Ничего не устанавливается и ничего никуда не отправляется. Откройте учебную спеку под виджетом и читайте её рядом с выводом.

Попробуйте

Запустите тесты в плеере, затем переключите бэкенд и найдите одну и ту же функцию на двух языках.

+
hello_world.t27, compiled inside the postВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tutorial/02_functions.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Тесты — часть спеки

+
+

Вы узнаетеПочему каждая спека t27 несёт свои тесты и что показывает временная диаграмма.

В t27 спека не закончена без своих утверждений: блоки test, инварианты и бенчи живут в том же файле, что и проверяемый ими код, а спеку без них компилятор отвергает. Тест можно запустить и как вентили в симуляторе. Диаграммы ниже — настоящая симуляция Verilog, сгенерированного из спеки троичного умножения с накоплением, на тестовых векторах этой же спеки.

Попробуйте

Приблизьте один такт и прочитайте значения на шинах в отметке pass.

+
Test waves: a t27 spec's tests, simulated and drawn as wavesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tutorial/07_tests_invariants_benches.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Компилируется — не значит верно

+
+

Вы узнаетеПочему зелёные галочки — не доказательство и как поймать код, который компилируется и неверен.

Компилятор, принявший ваш код, говорит только, что код правильно оформлен. Он не говорит, что код значит то, что вы имели в виду. Эта запись показывает инструмент, нашедший спеки, которые компилируются, проходят все проверки и всё равно прочитаны неправильно. Для железа урок ещё жёстче: ошибку в кремнии не исправить патчем. Внесите ошибку сами в записи с мутациями и посмотрите, как тесты её ловят.

Попробуйте

Откройте запись с мутациями в «Ещё попробуйте» и посчитайте, сколько подложенных ошибок поймали тесты.

+
tri misread: code that compiles and is wrongВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tutorial/03_operators.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Внутри t27c

Как компилятор читает спеку и что он пишет, включая нативный t27b.

+
+
10

Урок 10 из 27

Стадии t27c

+
+

Вы узнаетеПуть спеки внутри t27c: токены, синтаксическое дерево, типы, HIR, код.

t27c читает спеку по стадиям. Лексер режет текст на токены. Парсер строит синтаксическое дерево. Проверка типов проверяет каждую ширину и каждый вызов. Дерево опускается в HIR, более простую форму, и каждый бэкенд пишет код из неё. Этот виджет прогоняет стадии на спеке в вашем браузере и показывает, что выдала каждая, так что у ошибки есть стадия, на которую можно указать.

Попробуйте

Выберите пример и пройдите по стадиям; найдите стадию, на которой остановилась бы ошибка типов.

+
Inside t27c: watch a compiler read your code, stage by stageВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tutorial/06_structs_enums_switch.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

t27c на настоящей машине

+
+

Вы узнаетеТот же компилятор на настоящей машине, печатающий то, что он действительно печатает.

Плеер в уроке 7 запускает компилятор в вашем браузере. Эта запись — нативный t27c, написанный на Rust, запущенный на настоящей машине на том же hello_world.t27: он сообщает статус спеки, тесты и инварианты, которые выпускает, и модуль Verilog с параметрами. Каждый байт записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите строку, где t27c печатает параметры модуля Verilog.

+
t27c on hello_world.t27Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/demos/hello_world.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Семь бэкендов и t27b

+
+

Вы узнаетеОдна спека, много целевых языков и нативный компилятор без LLVM.

Одна спека t27 может стать Zig, C, Rust, JavaScript, TypeScript или Verilog; Verilog получается двумя путями, прямо из спеки и через HIR, — вот и семь бэкендов. Плеер показывает Rust, который t27c пишет для hello_world. t27b — второй компилятор: нативный машинный код AArch64, без LLVM, JIT для тестов и объектные файлы Mach-O. Он не закончен, и мы говорим, насколько: в запуске 26c447ad8 он прошёл 307 из 449 спек, которые эталонный компилятор проходит с тестами, 68.4%.

Попробуйте

Переключите плеер на JavaScript в «Ещё попробуйте», сгенерируйте модуль и запустите его.

+
hello_world.t27 to Rust, in a terminal inside the postВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tutorial/08_modules_and_arrays.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · От спеки к железу

Verilog, который пишет t27c, ячейки, в которые он превращается, и что делает одна LUT.

+
+
13

Урок 13 из 27

От спеки к Verilog

+
+

Вы узнаетеКак функция t27 становится логикой, а тактируемая функция — регистрами.

Verilog — это текст, по которому синтезатор строит схему. t27c пишет его из спеки. Функция с именем on_clock становится блоком always по фронту такта, а каждая переменная модуля — регистром со сбросом. Откройте clocked_counter.t27 в плеере: 8-битный счётчик в несколько строк и Verilog, в который он превращается. В его заголовке записано, что из него построил yosys.

Попробуйте

Откройте clocked_counter.t27 в плеере и найдите блок always на вкладке Verilog.

+
hello_world.t27 to Verilog, in a terminal inside the postВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/clocked_counter.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Посчитайте ячейки

+
+

Вы узнаетеКак посчитать, что построил синтезатор: LUT, триггеры, DSP, блочную память.

После синтеза yosys может напечатать построенное в JSON: сколько LUT, триггеров, DSP и блоков памяти. Эти числа — честная мера дизайна до размещения и трассировки. Вставьте stat -json из yosys в карточку или откройте настоящий пример и получите карточку и бейдж для README, которые прямо говорят, что это подсчёт синтеза.

Попробуйте

Откройте настоящий пример и прочитайте на карточке число LUT и FF.

+
Stat card: your yosys stat -json as a card and a README badgeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tutorial/04_control_flow.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Одна LUT вблизи

+
+

Вы узнаетеЧто такое таблица истинности на 6 входов и как 64 бита описывают любой вентиль.

LUT6 — это крошечная память с 6 адресными входами и 64 однобитными ячейками. Любая логическая функция от 6 входов — это просто её таблица истинности, записанная в эти 64 бита, значение INIT. Вставьте INIT, и виджет прочитает его обратно как таблицу истинности и выражение. Потом сыграйте в угадайку на LUT из настоящего оттрассированного дизайна: XOR, AND, мультиплексор или что-то без короткого имени.

Попробуйте

Попробуйте примеры XOR6 и majority, затем сыграйте пять раундов Guess the gate. В спеке full_adder собран из xor2 и maj3: какая из них даёт перенос и сколько нейронов на неё уходит, по словам спеки?

+
LUT explain: a 7-series LUT6 INIT and its FASM line, read as logicВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/ternary_full_adder.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Читаем синтез

Что yosys сообщает о вашем дизайне и какие предупреждения важны.

+
+
16

Урок 16 из 27

Важные предупреждения синтеза

+
+

Вы узнаетеКак читать лог yosys и какие предупреждения становятся ошибками на кремнии.

yosys сообщает много, и почти всё это нормально. Несколько строк — нет: защёлка, которую вы не задумывали, провод, который никто не ведёт, два драйвера на одной цепи, память, ставшая триггерами. Всё это работает в симуляции и ломается на чипе. Откройте один из настоящих логов спек t27, затем вставьте свой.

Попробуйте

Откройте каждый настоящий лог и найдите тот, который yosys отверг, и почему. В спеке проход по модулям считает, что он вычистил: найдите три счётчика CrossOptPass и тест, где они в сумме дают 17.

+
Synth smells: a lint card for your yosys logВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/crossopt.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Конечные автоматы

+
+

Вы узнаетеКак синтезатор находит в дизайне конечный автомат — или отказывается.

Многие дизайны — конечные автоматы: регистр хранит текущее состояние, а логика выбирает следующее. yosys ищет их и, найдя, может перекодировать. Когда он отказывается, он говорит почему. Виджет рисует граф, который yosys извлёк из настоящих дизайнов, приёмника UART и мастера SPI flash, и показывает случай, где он отказался.

Попробуйте

Откройте пример uart_rx и посчитайте его состояния и переходы. Порт JTAG тоже работает как конечный автомат: найдите в спеке тест, который говорит, сколько состояний у контроллера TAP.

+
FSM sketch: the state machine yosys found in your RTLВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/dft.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Куда уходят LUT

+
+

Вы узнаетеКакая часть дизайна тратит LUT и почему важна иерархия.

Дизайн собран из модулей, внутри которых модули. Когда yosys сохраняет иерархию, он считает каждый подмодуль один раз, а число экземпляров говорит, сколько копий. Treemap перемножает их и показывает, какой подмодуль съедает LUT. Один сумматор, использованный много раз, может стоить больше всего остального вместе.

Попробуйте

Переключайтесь между иерархическим и плоским итогом и найдите самый большой прямоугольник. В спеке найдите fpga_util и тест, который переводит 31700 занятых LUT в долю одного чипа: сколько процентов получается?

+
LUT treemap: which submodule eats your LUTs, from yosys stat -jsonВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/partition.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Размещение, трассировка, тайминг

Где ячейки оказываются на кристалле и успевает ли тактовая частота.

+
+
19

Урок 19 из 27

Размещение: где оказываются ячейки

+
+

Вы узнаетеЧто делают размещение и трассировка и куда они поставили настоящий дизайн.

Синтез говорит, какие ячейки нужны. Размещение и трассировка решают, где каждая сидит на кристалле и какие провода их соединяют. В открытом маршруте обе задачи решает nextpnr-xilinx. Карта рисует каждую размещённую ячейку настоящего запуска на XC7A200T: маленький дизайн — маленькое скопление на огромном чипе.

Попробуйте

Подгоните дизайн по размеру, затем нажимайте на ячейки разных типов и читайте их имена BEL. В спеке найдите RegionKind: какие два из пяти его видов — столбцы и какой тест проверяет, что столбец BRAM шириной в 1?

+
Placement map: where nextpnr put every cell on the XC7A200TВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/placement.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Глубина логики

+
+

Вы узнаетеПочему самая длинная цепочка логики задаёт, насколько быстро может работать дизайн.

Сигналу нужно время, чтобы пройти каждую LUT и каждый провод. Самая длинная цепочка логики между двумя регистрами задаёт, как часто может тикать такт. yosys может показать эту цепочку как число ячеек ещё до трассировки. Лестница рисует её для настоящего сумматора GF16, шаг за шагом.

Попробуйте

Откройте настоящий пример и посчитайте, сколько шагов пути — это LUT. В спеке est_comb_delay берёт 100 пс за каждую LUT и ещё 300 пс на трассировку: найдите тест, который получает 600 для трёх LUT.

+
LUT depth: your longest yosys path, drawn as a staircaseВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/timing.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

Тайминг и запас

+
+

Вы узнаетеЧто такое slack и как читать отчёт о тайминге путь за путём.

Slack — сколько времени остаётся на пути, когда кончается период такта. Положительный запас: путь достаточно быстрый. Отрицательный: на этой частоте дизайн не работает. Каждая полоса здесь — настоящий путь оттрассированного дизайна на 50 МГц, разбитый на логику и трассировку, худшие сверху. Найдите, куда уходит время на худшем пути.

Попробуйте

Нажмите на худший путь и сравните время логики со временем трассировки. В спеке у каждого clock_tree перекос 100 пс: найдите тест, где бюджет 50 пс не выдерживается, и тот, где 200 пс проходит.

+
Slack waterfall: every timing path of a routed design, worst firstВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/cts.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Битстрим

Как оттрассированный дизайн становится битами, которые загружает чип, без Vivado.

+
+
22

Урок 22 из 27

От FASM к фреймам

+
+

Вы узнаетеЧто такое FASM и как фичи становятся конфигурационными фреймами.

После трассировки дизайн — это список фич, которые надо включить, в текстовом формате FASM: у этой LUT такой INIT, этот провод соединён с тем. Инструменты prjxray превращают фичи в конфигурационные фреймы, блоки битов, которые загружает чип. Эта запись делает этот шаг собственным инструментом t27 и сравнивает каждый фрейм с эталонным инструментом: они совпадают байт в байт.

Попробуйте

Найдите место, где запись говорит, сколько фреймов совпало и из скольких. В спеке HELP_LINE говорит, что tri x7-fasm сверяет с fasm2frames: сколько из его 20 записей настоящие и сколько должны быть отвергнуты?

+
tri x7-fasm · a bitstream assembled without VivadoВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/x7-fasm.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Сборка по пунктам

+
+

Вы узнаетеКаждая стадия от спеки до битстрима — с временем, инструментом и хешем.

Целая сборка от спеки t27 до битстрима Artix-7, расписанная как чек из магазина: каждая стадия, инструмент и его версия, затраченное время и sha256 того, что она записала. Нигде нет Vivado. Когда число в чеке можно проверить, любой может пересобрать и сравнить хеш.

Попробуйте

Прочитайте чек: какая стадия шла дольше всех и какой инструмент её выполнял? В спеке RECEIPT_KINDS называет два вида чека: какой из них — только сборка и какая запись в ERRORS ловит его, когда он выдаёт себя за другой?

+
Build receipt: t27 spec to XC7A200T bitstream, no VivadoВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/adapter.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Читаем битстрим

+
+

Вы узнаетеЧто внутри файла .bit и для какого чипа он собран.

Файл .bit — это заголовок, за которым идут пакеты: команды логике конфигурации чипа и сами фреймы. Одна из этих команд записывает IDCODE чипа, для которого файл собран. Бросьте .bit во вскрытие и увидите, какой чип он просит. Пять битстримов, закоммиченных в t27, оказываются собраны для другой детали, чем наш стенд.

Попробуйте

Откройте пример blink_j26 и сравните деталь в его заголовке с IDCODE, который он записывает. В спеке прочитайте HELP_LINE: с каким эталонным инструментом tri x7-writer совпадает байт в байт и какой вход он отвергает?

+
Bitstream autopsy: which FPGA a 7-series .bit really targetsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/x7-writer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · На плате

Спросите чип, кто он, загрузите биты и проверьте их.

+
+
25

Урок 25 из 27

JTAG спрашивает чип

+
+

Вы узнаетеКак кабель находит чип на плате и читает его IDCODE.

JTAG — это протокол кабеля для разговора с чипом на плате. Перед прошивкой инструмент выдвигает IDCODE каждого устройства в цепочке. Эта запись декодирует коды, которыми отвечает наш стенд, и показывает, что значит чётный код: IDCODE нет вовсе. Сравните с декодером из урока 2.

Попробуйте

Найдите, какой IDCODE принадлежит XC7A200T, а какой XC7A100T. В спеке HELP_LINE говорит, как tri fpga-jtag читает цепочку без ответа: что он винит, если пришли все единицы, а что — если все нули?

+
tri fpga-jtag · which chip answered the cableВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/fpga-jtag.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Те же биты — на плате

+
+

Вы узнаетеКак показать, что битстрим совпадает байт в байт и что он работает.

Утверждение, в котором сомневается большинство людей из FPGA: битстрим, собранный открытым маршрутом из спек t27, совпадает байт в байт с эталонным тулчейном и работает на настоящей плате. Эта запись сравнивает файлы, загружает биты в SRAM чипа и считает квитанции, которые присылает плата. Бросьте два файла .bit в bit-diff, чтобы проверить совпадение сами.

Попробуйте

Дождитесь счёта квитанций в конце, затем попробуйте bit-diff в «Ещё попробуйте». В спеке ACTIONS перечисляет шаги tri x7-board: какой из них загружает SRAM чипа и какой флаг ему нужен по HELP_LINE?

+
A bitstream from t27 specs, run on the AX7203Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/tools/trios/tri/x7-board.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Итог: переугадайте yosys

+
+

Вы узнаетеСоберите всё вместе: угадайте, сколько LUT стоит настоящий модуль t27.

Всё из этого курса в одной игре. Каждый день Gatle показывает один настоящий модуль t27 и Verilog, который ваш браузер из него компилирует; у вас шесть попыток угадать, сколько LUT на него потратил yosys. Используйте то, что знаете: ширины, умножители, иерархию, состояние. Потом посмотрите, как ещё люди и агенты соревнуются на t27.

Попробуйте

Сыграйте сегодняшнюю задачу. Затем прочитайте Verilog модуля и объясните, почему он стоил столько, сколько стоил. Запустите тесты в спеке: сколько из 12 инструкций hello_kernel — операции GF16 и какой тест говорит, что все 12 занимают 48 байт?

+
Gatle: guess how many LUTs yosys spends on today's t27 moduleВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/fpga/e2e_demo.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Чип
    1. 01 FPGA — это сетка, которую вы настраиваете
    2. 02 Какой это чип?
    3. 03 Выводы, шарики и корпус
  2. 02 · Числа в железе
    1. 04 Биты, триты и GF16
    2. 05 Сколько стоит арифметика
    3. 06 Сколько помещается на чип
  3. 03 · Ваша программа на t27
    1. 07 Привет, t27
    2. 08 Тесты — часть спеки
    3. 09 Компилируется — не значит верно
  4. 04 · Внутри t27c
    1. 10 Стадии t27c
    2. 11 t27c на настоящей машине
    3. 12 Семь бэкендов и t27b
  5. 05 · От спеки к железу
    1. 13 От спеки к Verilog
    2. 14 Посчитайте ячейки
    3. 15 Одна LUT вблизи
  6. 06 · Читаем синтез
    1. 16 Важные предупреждения синтеза
    2. 17 Конечные автоматы
    3. 18 Куда уходят LUT
  7. 07 · Размещение, трассировка, тайминг
    1. 19 Размещение: где оказываются ячейки
    2. 20 Глубина логики
    3. 21 Тайминг и запас
  8. 08 · Битстрим
    1. 22 От FASM к фреймам
    2. 23 Сборка по пунктам
    3. 24 Читаем битстрим
  9. 09 · На плате
    1. 25 JTAG спрашивает чип
    2. 26 Те же биты — на плате
    3. 27 Итог: переугадайте yosys
+ + + + + diff --git a/apps/website/public/ru/learn/course/index.html b/apps/website/public/ru/learn/course/index.html index f9ed6b7402..0c75ff448b 100644 --- a/apps/website/public/ru/learn/course/index.html +++ b/apps/website/public/ru/learn/course/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

С нуля до чипа: программирование FPGA на t27

Опыт с железом не нужен. Каждый урок открывает настоящий инструмент, собранный из реальных запусков на нашем стенде: прочитайте немного и попробуйте сами.

27 уроков, в каждом рабочий виджет и спека t27: что такое FPGA, как числа становятся битами, ваша спека на t27, как её компилирует t27c и как она превращается в битстрим на настоящей плате.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/coverage-lies/index.html b/apps/website/public/ru/learn/coverage-lies/index.html index cd776602af..c954a5583a 100644 --- a/apps/website/public/ru/learn/coverage-lies/index.html +++ b/apps/website/public/ru/learn/coverage-lies/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Покрытие лжёт

Вы научитесь

Почему процент покрытия бывает проверкой, которая ничего не проверила, и как это распознать.

Процент покрытия — заявление о тестах, и заявления бывают пустыми. Виджет нашёл пустой вид: 11 spec отвергнуты на разборе, 0 заблокированы только прозой, и 23 сломаны нарочно как фикстуры — но где-то ещё в корпусе «тест», являющийся только прозой, проходит все проверки, ничего не исполняя. Приметы всегда одни: число без знаменателя, проход без исполнившегося ассерта, прогон, который не может упасть. Спрашивайте с каждого процента: что сдвинуло бы это число?

Попробуйте

В прогоне по прозе найдите разницу между «отвергнут на разборе» и «заблокирован только прозой»; затем напишите тест, чей проход не исполняет ни одного ассерта.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri prose report: prose, or code?
tri prose report: prose, or code? ↗

11 specs refused at parse, 0 blocked only by prose, 23 broken on purpose as fixtures.

specs/fpga/testbench/fifo_tb.t27

// FIFO testbench spec
@@ -302,6 +334,7 @@ 

Покрытие лжёт

}

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/create-clock/index.html b/apps/website/public/ru/learn/create-clock/index.html index 645eb475d7..97be21fecc 100644 --- a/apps/website/public/ru/learn/create-clock/index.html +++ b/apps/website/public/ru/learn/create-clock/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Строка create_clock

Вы узнаете

Что строка create_clock сообщает анализатору и какая спека её пишет.

Пока строки create_clock нет, анализатор не видит клока вовсе и ничего не хронометрирует: каждый путь без ограничений, каждый отчёт пуст. Строка называет порт, период и фронты формы волны. emitter_xdc.t27 — спека эмиттера, который пишет такие строки из спеки выводов, — её текст несёт create_clock -add -name среди строк, которые она выпускает. Нативный test-report на этой спеке в текущем дереве заблокирован, поэтому запись показывает то, что работает: t27c parse спеки, чисто, и grep, находящий её строки create_clock. Плеер компилирует спеку в браузере.

Попробуйте

В записи найдите строки create_clock, которые возвращает grep; затем в окне спеки найдите построитель строк эмиттера и скажите, чего нехватка create_clock делает с отчётом тайминга.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on emitter_xdc.t27 -- the XDC emitter, parsed
t27c on emitter_xdc.t27 -- the XDC emitter, parsed ↗

The pins-to-XDC emitter spec through t27c 0.4.0: the head of its AST and the create_clock lines it exists to write. Native test-report is blocked on this spec; parse is clean.

specs/pins/emitter_xdc.t27

// SPDX-License-Identifier: Apache-2.0
@@ -362,6 +394,7 @@ 

Строка create_clock

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/cross-entropy/index.html b/apps/website/public/ru/learn/cross-entropy/index.html index c769dd6cba..a50422585e 100644 --- a/apps/website/public/ru/learn/cross-entropy/index.html +++ b/apps/website/public/ru/learn/cross-entropy/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Перекрёстная энтропия

Вы узнаете

Почему перекрёстная энтропия так дорого берёт за уверенный неверный ответ и почему именно это учит классификатор.

Классификатор выдаёт вероятность, а перекрёстная энтропия берёт -log вероятности, которую он дал верному ответу. Предсказания 0.8, 0.3 и 0.9 против ответов 1, 0 и 1 стоят в среднем 0.2284. Быть уверенным и правым почти бесплатно: 0.99, 0.01 и 0.99 стоят 0.0101. Быть уверенным и неправым дорого: 0.01, 0.99 и 0.01 стоят 4.6052, а к 0 стоимость растёт без предела, поэтому спека обрезает p до [1e-7, 1 - 1e-7]. Её градиент наибольший как раз там, где модель уверена и неправа. Спека binary_crossentropy_loss.t27 вычисляет потерю и градиент, из вероятностей или из логитов.

Попробовать

Тяните предсказание 0 к 0.01 и смотрите на кривую; затем прочитайте столбики градиента при 0.5, 0.5 и 0.5.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Cross-entropy: why a confident wrong answer costs so much
Cross-entropy: why a confident wrong answer costs so much ↗

Set three predicted probabilities against the answers 1, 0, 1: the loss is -log of the chance given to the truth. Drag toward a confident mistake and the cost climbs without bound.

specs/ml/loss/binary_crossentropy_loss.t27

// SPDX-License-Identifier: Apache-2.0
@@ -282,6 +314,7 @@ 

Перекрёстная энтропия

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/debug-with-waves/index.html b/apps/website/public/ru/learn/debug-with-waves/index.html index 019442f285..f5edf4fc0b 100644 --- a/apps/website/public/ru/learn/debug-with-waves/index.html +++ b/apps/website/public/ru/learn/debug-with-waves/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Отладка по волнам

Вы научитесь

Как пройти от симптома к сигналу, такт за тактом, на настоящем измеренном баге.

Вот баг, найденный волнами, от начала до конца. Линк UART на стенде запросил 115,200 бод, а провод нёс 115,385 — ошибку +0.16 % от делителя частоты, невидимую в коде и очевидную в захвате. Запрошено 921,600 — провод несёт 923,077, та же дробная ошибка; 3,000,000 делится нацело и на проводе точно. Измерение называет исправление: брать делители, дающие целые частоты. Волны превращают симптом (потерянные байты) в число (0.16 %) и в правку.

Попробуйте

Посчитайте, какой делитель положил бы 115,200 на провод точно; сверьте с рядами 921,600 и 3,000,000 в виджете.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-wire · the baud rate actually on the wire
tri fpga-wire · the baud rate actually on the wire ↗

CP2102N on a direct USB port, no hub. Requested 115,200 puts 115,385 on the wire (+0.16 %), 921,600 puts 923,077 (+0.16 %), 3,000,000 is exact.

specs/fpga/testbench/vcd_trace_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -159,6 +191,7 @@ 

Отладка по волнам

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/decode-in-one-step/index.html b/apps/website/public/ru/learn/decode-in-one-step/index.html index e3b4e724f2..96bf977b06 100644 --- a/apps/website/public/ru/learn/decode-in-one-step/index.html +++ b/apps/website/public/ru/learn/decode-in-one-step/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Раскодировать за один шаг

Вы узнаете

Почему формат с полями фиксированной длины раскодирует поля параллельно, а позит не может, как спека считает шаги.

Позит кладёт перед порядком режим переменной длины, поэтому декодер должен найти конец режима, прежде чем сможет прочитать что-то ещё. GF16 и IEEE FP16 держат каждое поле на фиксированном месте, поэтому все поля раскодируются сразу. gf_competitive.t27 считает шаги: 3 у FP16, 6 у POSIT16, 3 у GF16, и отмечает, какие можно выполнять параллельно. Это числа, вписанные в спеку, а не время, измеренное на железе.

Попробуйте

Найдите decode_complexity и три записи, которые она возвращает. Затем найдите инвариант, который сравнивает позит с GF16, и скажите, что добавило бы измерение времени на железе.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 27: decode in one step
GoldenFloat 27: decode in one step ↗

Decode steps as gf_competitive.t27 counts them, read from gf_competitive.t27. Lesson 27 of the GoldenFloat course.

specs/math/gf_competitive.t27

// SPDX-License-Identifier: Apache-2.0
@@ -189,6 +221,7 @@ 

Раскодировать за один шаг

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/depth-sizing/index.html b/apps/website/public/ru/learn/depth-sizing/index.html index 04c9da8821..eca815f855 100644 --- a/apps/website/public/ru/learn/depth-sizing/index.html +++ b/apps/website/public/ru/learn/depth-sizing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Выбор глубины

Вы узнаете

Как глубина следует из скорости записи, скорости чтения и худшей пачки и что измеряет настоящий хронометрированный цикл.

Глубина — не чувство: запись идёт со скоростью W, чтение со скоростью R, и буфер должен вместить худшую пачку, умноженную на (W - R), за время её длительности. Переразмеренный — тратит BRAM, который можно было потратить иначе; недоразмеренный — переполняется молча, потому что полный FIFO теряет или блокирует, и ни то, ни другое не видно на волновой диаграмме. Виджет — настоящий цикл с измеренным временем: 19,06 с на router1, bitwalk, xc7frames2bit и загрузку SRAM на ноутбуке при load average около 110 — та же арифметика скорости и времени, которая выбирает размер буфера, измеренная на запуске, который был на самом деле. Окно спеки открывает fifo.t27, чей fill_count — то самое число.

Попробуйте

В виджете найдите измеренное время цикла и load average, при котором он шёл; затем в окне спеки найдите fill_count и напишите формулу глубины для своей худшей пачки.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri competitors audit: the table, audited
tri competitors audit: the table, audited ↗

168 records: 14 papers entered twice, 141 cite no score, 144 state zero at pass@1.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Выбор глубины

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/designing-taps/index.html b/apps/website/public/ru/learn/designing-taps/index.html index 8b8fd65db2..c9840cd5eb 100644 --- a/apps/website/public/ru/learn/designing-taps/index.html +++ b/apps/website/public/ru/learn/designing-taps/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Расчёт коэффициентов

Вы узнаете

Как рассчитывается ФНЧ окном sinc и чего стоит округление его коэффициентов до целых.

Идеальный ФНЧ — это sinc; обрежьте его до конечного числа отводов и умножьте на окно, и появится полоса задерживания. При 31 отводе и срезе 0.1 без окна полоса задерживания от 0.2 остаётся на -32.8 дБ; окно Хэмминга опускает её до -62.6 дБ, а Блэкмана — до -76.1 дБ. Затем коэффициенты становятся целыми: на 16 битах полоса задерживания Хэмминга почти не двигается, на 8 битах поднимается обратно до -32.8 дБ. Спека signals.t27 рассчитывает коэффициенты и вычисляет обе характеристики.

Попробовать

Переключайте три окна при 31 отводе; затем уменьшайте биты коэффициентов, пока полосу задерживания не начнут задавать биты, а не окно.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Designing FIR taps: a window, a cutoff, and the bits you keep
Designing FIR taps: a window, a cutoff, and the bits you keep ↗

Set taps, cutoff, window and coefficient bits. Watch the integer taps and the response: a better window deepens the stopband, too few bits fill it back in.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Расчёт коэффициентов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/directed-vs-random/index.html b/apps/website/public/ru/learn/directed-vs-random/index.html index cff4a7a47c..03f4823571 100644 --- a/apps/website/public/ru/learn/directed-vs-random/index.html +++ b/apps/website/public/ru/learn/directed-vs-random/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Направленные против случайных

Вы научитесь

Когда один выбранный случай стоит тысячи случайных, а когда нет.

Направленный тест — один случай, выбранный потому, что вы знаете: он кусается. Пустой FIFO, полный FIFO, переход через границу. Случайный тест — дешёвый объём. Это не соперники, это последовательность. Виджет — эксперимент-нокдаун, превращённый в инструмент: заявлены три бита производительности, и на каждый бит собран отдельный битстрим-нокдаун — тот же дизайн с выключенным битом, — доказывающий, что бит важен. В этом весь аргумент направленных тестов: один бит, один прогноз, один битстрим, одно измерение.

Попробуйте

Выберите один бит производительности в виджете-нокдауне и скажите, что должен показать прогон без нокдауна, чтобы бит оказался ложью.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Three PERF2 bits, and one knockout bitstream per bit
Three PERF2 bits, and one knockout bitstream per bit ↗

The A/B bitstreams differ in three bits. Each knockout clears one: 3 bytes from the working .bit.

specs/fpga/testbench/uart_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -464,6 +496,7 @@ 

Направленные против случайных

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/does-it-fit-and-close-timing/index.html b/apps/website/public/ru/learn/does-it-fit-and-close-timing/index.html index 383d17c538..a3dbff23bf 100644 --- a/apps/website/public/ru/learn/does-it-fit-and-close-timing/index.html +++ b/apps/website/public/ru/learn/does-it-fit-and-close-timing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Помещается ли и сходится ли тайминг?

Вы узнаете

Как составить бюджет слайсов DSP для многоканального фильтра и почему тайминг срывает дерево сумматоров, а не умножитель.

Шестнадцать каналов симметричного фильтра на 63 отвода на 50 МГц при такте 250 МГц занимают по 7 слайсов, 112 из 740 у XC7A200T. Сойдётся ли тайминг — вопрос об одном пути от регистра к регистру: прямое дерево сумматоров ставит в него ceil(log2 63) = 6 сумматоров, систолическая цепь через каскад слайсов — один. При заданных вами задержках дерево не укладывается в период 4000 пс, а цепь укладывается. Спека signals.t27 считает; отчёт о тайминге вашей сборки измеряет.

Попробовать

Загрузите пресет с деревом сумматоров, переключите его на систолическую цепь и прочитайте запас; затем найдите, сколько каналов фильтра на 127 отводов помещается.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Does it fit, and does it close timing?
Does it fit, and does it close timing? ↗

Set a filter, its rates and a channel count: watch the 740 DSP slices of an XC7A200T fill, and a register-to-register path race the clock period.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Помещается ли и сходится ли тайминг?

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/dropout/index.html b/apps/website/public/ru/learn/dropout/index.html index 869adb2a1f..51c5f153bd 100644 --- a/apps/website/public/ru/learn/dropout/index.html +++ b/apps/website/public/ru/learn/dropout/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Dropout: выключенные нейроны

Вы узнаете

Почему выключение нейронов во время обучения помогает и почему выживших нужно масштабировать.

Во время обучения dropout случайно выключает долю p нейронов, чтобы остальные не опирались ни на один из них. Выжившие нейроны тогда нужно масштабировать, иначе следующий слой видел бы сигнал другого размера при обучении, чем при выводе. Обратный dropout умножает их на 1 / (1 - p) при обучении: с p = 0.5 вход 1, 2, 3, 4 становится 2, 0, 6, 0, а вывод это простой проход. Классический dropout оставляет 1, 0, 3, 0 и умножает на 0.5 уже при выводе. Спека dropout_layer.t27 использует фиксированную маску, оставить, выбросить, оставить, выбросить, поэтому числа каждый раз одинаковые.

Попробовать

Сравните выходы четырёх режимов; затем прочитайте градиент выброшенного нейрона при обучении.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Dropout: training a network with neurons switched off
Dropout: training a network with neurons switched off ↗

Switch between training and inference, inverted and classic dropout: units 1 and 3 are dropped, the survivors are scaled so that the layer's output keeps its expected size.

specs/ml/layers/dropout_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -201,6 +233,7 @@ 

Dropout: выключенные нейроны

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/elu/index.html b/apps/website/public/ru/learn/elu/index.html index a49d27db61..f180e26e26 100644 --- a/apps/website/public/ru/learn/elu/index.html +++ b/apps/website/public/ru/learn/elu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

ELU: пол, а не обрыв

Вы узнаете

Как ELU сохраняет мягкую отрицательную сторону с полом на -alpha и почему её наклон никогда не умирает до конца.

ELU сохраняет положительную сторону ReLU и заменяет обрыв на отрицательной стороне кривой alpha (e^x - 1), которая выполаживается к -alpha. При alpha 1 вход x = -3 даёт -0.9502, уже близко к полу -1, а наклон там 0.0498: мал, но не 0, так что нейрон ещё может сдвинуться. Отрицательные выходы не выбрасываются, поэтому среднее выходов слоя ближе к 0. Спека elu_activation.t27 вычисляет кривую, наклон и пол, а также свой пакет при -1, 0 и 2: -0.632, 0 и 2.

Попробовать

Поставьте alpha на 0.5 и прочитайте пол; затем найдите, как далеко влево должен уйти x, чтобы наклон стал меньше 0.01.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

ELU: a negative side with a floor
ELU: a negative side with a floor ↗

Drag along ELU: x above zero, alpha (e^x - 1) below. The negative side never falls under -alpha, so outputs average closer to zero, and its slope never quite dies.

specs/ml/activation/elu_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -190,6 +222,7 @@ 

ELU: пол, а не обрыв

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/embeddings/index.html b/apps/website/public/ru/learn/embeddings/index.html index ce37429895..20fb3de500 100644 --- a/apps/website/public/ru/learn/embeddings/index.html +++ b/apps/website/public/ru/learn/embeddings/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Эмбеддинги

Вы узнаете

Как токен превращается в строку чисел и почему обучение меняет только прочитанные строки.

Сеть не умеет умножать слово, поэтому каждый токен это индекс в таблице с одной строкой чисел на токен, а поиск токена копирует его строку. В спеке в таблице 4 токена шириной 2, и строка v хранит (10 v, 10 v + 1), так что токен 2 читает (20, 21). Обучение отправляет градиент назад только в прочитанные строки, а токен, прочитанный дважды, собирает оба: строки градиента (1, 2) и (3, 4) на токене 2 складываются в (4, 6). Спека embedding_layer.t27 вычисляет поиск и градиент.

Попробовать

Прочитайте токен 2 дважды, а затем токены 1 и 3; каждый раз сосчитайте строки, где градиент не 0.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Embeddings: how a word becomes a row of numbers
Embeddings: how a word becomes a row of numbers ↗

Pick two tokens: each one copies its row out of the table. Then the gradient flows back only into the rows that were read, and a token read twice collects both.

specs/ml/layers/embedding_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -233,6 +265,7 @@ 

Эмбеддинги

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/end-to-end-scenarios/index.html b/apps/website/public/ru/learn/end-to-end-scenarios/index.html index 4818a1fa2f..777aaac6e2 100644 --- a/apps/website/public/ru/learn/end-to-end-scenarios/index.html +++ b/apps/website/public/ru/learn/end-to-end-scenarios/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сквозные сценарии

Вы научитесь

Как сценарий проходит весь поток и что сквозной прогон доказывает, чего не могут юниты.

Юнит-тесты проверяют детали; сценарий проверяет трубу. Spec урока, e2e_demo, проводит один дизайн от spec до платы за один прогон, поэтому сбой в любом месте цепи падает в одной точке с именем. Виджет рисует весь FPGA-поток по слою на строку — spec, Verilog, ячейки, размещение, битстрим, плата — и сквозной сценарий — ровно эта картинка, превращённая в тест: каждый слой либо производит свой артефакт, либо останавливает прогон.

Попробуйте

Пройдите по виджету потока слой за слоем и назовите артефакт каждого слоя; затем найдите в e2e_demo место, где пропавший артефакт останавливает прогон.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri devkit · the FPGA flow, layer by layer
tri devkit · the FPGA flow, layer by layer ↗

One real XC7A200T build: 116.9 s with openXC7, 83.5 s with t27 L3+L4, byte-identical. Place & route is 60%.

specs/fpga/e2e_demo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -320,6 +352,7 @@ 

Сквозные сценарии

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/enough-reviewers/index.html b/apps/website/public/ru/learn/enough-reviewers/index.html index 460a6ad890..e208c56589 100644 --- a/apps/website/public/ru/learn/enough-reviewers/index.html +++ b/apps/website/public/ru/learn/enough-reviewers/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Хватит ли ревьюеров

Вы узнаете

Сколько ревью должно идти сразу, чтобы ревьюер успевал за пчёлами.

Ревью может занять REVIEW_ROW_SECONDS, 300 с, поэтому один слот проверяет не больше 12 строк в час. На 2026-10-09 пчёлы заканчивали около 58 в час, пока ждали 111 строк, а постоянный REVIEWER_CONCURRENCY, равный 4, даёт не больше 48. slots_needed(58) равно 5. reviewer_concurrency учитывает ключи, их полосы и свободную память, никогда не поднимается выше 16 и не опускается ниже 1, пока что-то ждёт, а keeps_up сравнивает это с темпом завершения.

Попробовать

Найдите наименьшее число ключей с 1 полосой, при котором ревьюер успевает за 58 в час; затем урежьте память до 1000 МБ.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

How many reviewer bees: keeping up with the finish rate
How many reviewer bees: keeping up with the finish rate ↗

Set the keys, lanes, memory and the rows waiting: reviewer_concurrency says how many reviews run at once, and keeps_up says whether that outruns the bees finishing work.

specs/queen/reviewer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -383,6 +415,7 @@ 

Хватит ли ревьюеров

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/enums/index.html b/apps/website/public/ru/learn/enums/index.html index b8a5e4d072..75fa8717dc 100644 --- a/apps/website/public/ru/learn/enums/index.html +++ b/apps/website/public/ru/learn/enums/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Перечисления

Вы узнаете

Два способа объявить enum и как switch читает значение.

pub enum Color { Red, Green, Blue } называет три случая. Форма Zig pub const Mode = enum(u8) { Idle, Run } ещё и задаёт тип, в котором хранится случай, здесь u8. switch по значению перечисляет, что даёт каждый случай, и закрывает остальное через else. Обе формы в спеке урока чисто компилируются на всех 7 бэкендах.

Попробуйте

Добавьте в Color четвёртый цвет и обновите CASES_IN_COLOR, чтобы тест прошёл.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 18: two ways to write an enum
t27 basics 18: two ways to write an enum ↗

The two enum forms the t27 compiler accepts, side by side with their cases. Lesson 18 of the t27 basics course.

specs/basics/18_enums.t27

// SPDX-License-Identifier: Apache-2.0
@@ -90,6 +122,7 @@ 

Перечисления

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/everything-in-one-bench/index.html b/apps/website/public/ru/learn/everything-in-one-bench/index.html index ccba531587..474d7a5081 100644 --- a/apps/website/public/ru/learn/everything-in-one-bench/index.html +++ b/apps/website/public/ru/learn/everything-in-one-bench/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Всё в одном стенде

Вы узнаете

Что проверяет интеграционный стенд, когда все шины дизайна гоняются одновременно.

Интеграционный стенд гоняет все шины разом и спрашивает дизайн, держится ли он целиком: test_reset_all_modules, test_module_count, test_mac_uart_pipeline, test_spi_memory_pipeline, test_full_pipeline, семь тестов. Запись опускает тестбенч-спеку интеграции в Verilog: все шины дизайна в одном стенде.

Попробовать

В записи найдите пять тестов конвейеров; затем в спеке скажите, какие две шины соединяет интеграционный стенд.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on integration_tb.t27 -- the integration bench
t27c gen-verilog on integration_tb.t27 -- the integration bench ↗

The integration testbench spec lowered to Verilog: every bus of the design in one bench.

specs/fpga/testbench/integration_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -200,6 +232,7 @@ 

Всё в одном стенде

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/expressions/index.html b/apps/website/public/ru/learn/expressions/index.html index a6ee62d614..2e8d36d24f 100644 --- a/apps/website/public/ru/learn/expressions/index.html +++ b/apps/website/public/ru/learn/expressions/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Выражения

Вы узнаете

Арифметические операторы и сравнения на константах урока и bool, который возвращает сравнение.

Выражение соединяет имена и числа операторами. При A = 17 и B = 5 A + B равно 22, A - B равно 12, A * B равно 85, A / B равно 3, потому что целые делятся без дроби, а A % B равно 2, это остаток. Сравнения дают true или false. Ограничение тестового прогона на этом сайте: он не читает минус перед числом, поэтому отрицательные значения пишите константами.

Попробуйте

Поменяйте B на 4 и предскажите все пять результатов до запуска тестов.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 9: operators on two numbers
t27 basics 9: operators on two numbers ↗

Every arithmetic and comparison operator of a t27 test, applied to 17 and 5 by the lesson spec. Lesson 9 of the t27 basics course.

specs/basics/09_expressions.t27

// SPDX-License-Identifier: Apache-2.0
@@ -90,6 +122,7 @@ 

Выражения

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/false-path-and-max-delay/index.html b/apps/website/public/ru/learn/false-path-and-max-delay/index.html index d0e369cc29..e3ecffc93c 100644 --- a/apps/website/public/ru/learn/false-path-and-max-delay/index.html +++ b/apps/website/public/ru/learn/false-path-and-max-delay/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

False path и max delay

Вы узнаете

Что объявляет false path, что вместо этого ограничивает max delay и как выглядит удаление проверки в репозитории.

set_false_path сообщает анализатору, что переход асинхронный: не докладывай о нём, им владеет синхронизатор. За пределами этого он глушит настоящие отказы, поэтому поток CDC ставит рядом set_max_delay, который ограничивает путь синхронизатора вместо игнорирования — те два-три триггера всё равно должны быть близки по времени. False path — это проверка, убранная нарочно, и виджет показывает, как выглядит удаление проверок в репозитории: 14 дней слитых пул-реквестов, кто добавил тесты, кто поменял, кто снял ассерты, с точными строками из git. Окно спеки открывает timing.t27 — анализ, в котором исключения вырезают дыры.

Попробуйте

В виджете найдите пул-реквест, снявший ассерты, и строки, которые он забрал; затем в окне спеки найдите арифметику запаса, которую глушит false path.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-txhold: setup and hold from the routed SDF
tri fpga-txhold: setup and hold from the routed SDF ↗

Smallest hold 3445 ps on TXD1 against a 1000 ps bench; each TX pin's setup and hold from nextpnr's own SDF of the routed node.

specs/fpga/timing.t27

// SPDX-License-Identifier: Apache-2.0
@@ -446,6 +478,7 @@ 

False path и max delay

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/fasm-to-frames/index.html b/apps/website/public/ru/learn/fasm-to-frames/index.html index 167a4fc36d..e5d1b7bfb1 100644 --- a/apps/website/public/ru/learn/fasm-to-frames/index.html +++ b/apps/website/public/ru/learn/fasm-to-frames/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

От FASM к фреймам

Вы узнаете

Что такое FASM и как фичи становятся конфигурационными фреймами.

После трассировки дизайн — это список фич, которые надо включить, в текстовом формате FASM: у этой LUT такой INIT, этот провод соединён с тем. Инструменты prjxray превращают фичи в конфигурационные фреймы, блоки битов, которые загружает чип. Эта запись делает этот шаг собственным инструментом t27 и сравнивает каждый фрейм с эталонным инструментом: они совпадают байт в байт.

Попробуйте

Найдите место, где запись говорит, сколько фреймов совпало и из скольких. В спеке HELP_LINE говорит, что tri x7-fasm сверяет с fasm2frames: сколько из его 20 записей настоящие и сколько должны быть отвергнуты?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri x7-fasm · a bitstream assembled without Vivado
tri x7-fasm · a bitstream assembled without Vivado ↗

FASM to frames: 22 of 22 byte-identical to fasm2frames, ours 6.31 s in this run (fasm2frames took 150.7 s at corpus build). Frames to .bit: 16 of 16 byte-identical to xc7frames2bit; a wrong-part input is refused.

specs/tools/trios/tri/x7-fasm.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

От FASM к фреймам

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/fifo-testbench/index.html b/apps/website/public/ru/learn/fifo-testbench/index.html index 0aa3914bc2..48fa8fc770 100644 --- a/apps/website/public/ru/learn/fifo-testbench/index.html +++ b/apps/website/public/ru/learn/fifo-testbench/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Тестбенч FIFO

Вы узнаете

Как выглядит настоящая дисциплина тестбенча и почему этот урок открывает спеку FIFO и запись мутаций.

Тестбенч асинхронного FIFO гнал бы оба клока, рвал бы указатели нарочно и проверял бы, что флаги не врут. Спека тестбенча в этом дереве — пока не то: она не компилируется браузерным компилятором, а нативные запуски на ней заблокированы, поэтому урок открывает сам fifo.t27, а вместо тестбенча FIFO — запись дисциплины, которой он следовал бы: 5 подложенных багов в packets.t27 — бит полинома CRC, ширина адреса CRC, пустые операции LFRM, бит COR0 и длина слова type-2 — каждая мутация пересобирается и перепрогоняется, и каждая поймана. Когда появится настоящая спека тестбенча, урок возьмёт её.

Попробуйте

В записи перечислите 5 подложенных багов и посчитайте, сколько поймано; затем в окне спеки найдите флаги, которые настоящему тестбенчу пришлось бы рвать нарочно.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri discard top: what the parser throws away
tri discard top: what the parser throws away ↗

67 specs lose 23,578 tokens to parser recovery, each held at its pinned bound.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Тестбенч FIFO

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/five-channels/index.html b/apps/website/public/ru/learn/five-channels/index.html index 8136bcc1ab..de2a3aad2a 100644 --- a/apps/website/public/ru/learn/five-channels/index.html +++ b/apps/website/public/ru/learn/five-channels/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Пять каналов

Вы узнаете

Что несут пять независимых каналов AXI4 и что компилятор порождает для них.

AXI4 несёт пять независимых каналов: адрес записи, данные записи, отклик записи, адрес чтения, данные чтения. Спека заявляет ширины — AXI_ADDR_WIDTH 32, AXI_DATA_WIDTH 32, AXI_STRB_WIDTH 4, AXI_ID_WIDTH 4, AXI_LEN_WIDTH 8, AXI_SIZE_WIDTH 3 — под MAX_BUS_PORTS равным 32. Запись опускает спеку AXI4 в синтезируемый Verilog: разводку каналов и рукопожатия как порождённые провода.

Попробовать

В записи найдите каналы в порождённых проводах; затем в спеке перечислите шесть ширин AXI и скажите, что покрывает 8-битный LEN.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on axi4.t27 -- spec to RTL
t27c gen-verilog on axi4.t27 -- spec to RTL ↗

The AXI4 spec lowered to synthesizable Verilog: the five channels' wiring and handshakes as generated wires.

specs/fpga/axi4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -461,6 +493,7 @@ 

Пять каналов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/five-rules-for-weights/index.html b/apps/website/public/ru/learn/five-rules-for-weights/index.html index 63a6da4bc3..fff196e472 100644 --- a/apps/website/public/ru/learn/five-rules-for-weights/index.html +++ b/apps/website/public/ru/learn/five-rules-for-weights/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Пять правил для алфавита весов

Вы узнаете

Какие значения может принимать тернарный вес, как пять измеренных правил оставляют одну формулу и что из неё убирает шестое правило.

Спека golden_sieve.t27 задаёт тернарному весу пять измеренных правил и шестое, которое сужает то, что они оставляют. S1: число значений — степень тройки; S2: не больше двух тритов, так как третий не дал значимого выигрыша. S3: одна линия накопителя, поэтому отношение любых двух весов рационально: плюс и минус фи проходят как общий масштаб, а 1 и фи требуют двух линий. S4: не больше шести входных битов на нейрон — спека называет это компромиссом, а не законом; S5: никаких ячеек DSP48E1 и SRL16E, для которых openXC7 записывал неверный битстрим, хотя каждый инструмент говорил OK. Пять правил оставляют TNF(k, b) с 3 или 9 уровнями, а S6 убирает форму с 9 уровнями: на любой целочисленной лестнице старший вес перевешивает остальные вместе, и решает один вход. Браузер выполняет все 3 теста и все 8 инвариантов.

Попробуйте

Запустите тесты; затем поменяйте в исходнике MAX_TRITS на 3 и посмотрите, какие две проверки упадут. В спеке триты задают порядок числа, а не вес: найдите exp_values у tnf4 и тест, который говорит, какое смещение не конечно.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

golden_sieve.t27, the ternary sieve, compiled inside the post
golden_sieve.t27, the ternary sieve, compiled inside the post ↗

The Golden Sieve as a t27 spec: five predicates a ternary weight alphabet must pass, compiled by t27c as WebAssembly in your browser. Seven backends; every test runs in the page.

specs/numeric/tnf4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -115,6 +147,7 @@ 

Пять правил для алфавита весов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/five-trits-a-byte/index.html b/apps/website/public/ru/learn/five-trits-a-byte/index.html index d19b64d7ea..e66fc0f77e 100644 --- a/apps/website/public/ru/learn/five-trits-a-byte/index.html +++ b/apps/website/public/ru/learn/five-trits-a-byte/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Пять тритов в байте

Вы узнаете

Как 3^5 = 243 умещается под 2^8 = 256 и что значат 13 лишних кодов.

У пяти тритов 243 комбинации, а у байта 256, поэтому пять тритов умещаются в байт, и 13 кодов остаются лишними. Спека упаковывает их как число в основании 3, каждый трит плюс один, а распаковывает делением. Так используется 99.06% информации байта против 79.25% при двух битах на трит. Байты от 243 и выше вообще не являются кодами.

Попробовать

Упакуйте +1 +1 +1 +1 +1 и прочитайте байт; затем поставьте байт 243 и объясните, что говорит виджет.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Five trits in one byte: 243 of 256 codes
Five trits in one byte: 243 of 256 codes ↗

3^5 = 243 fits under 2^8 = 256. Press the trits to pack them, or drag the byte to unpack it; bytes from 243 up hold nothing.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Пять тритов в байте

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/flip-and-cut/index.html b/apps/website/public/ru/learn/flip-and-cut/index.html index 6cb2532041..f6fb96cc34 100644 --- a/apps/website/public/ru/learn/flip-and-cut/index.html +++ b/apps/website/public/ru/learn/flip-and-cut/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Переворот вместо минуса, отсечение вмест

Вы узнаете

Почему смена знака — это переворот каждого трита, а отбрасывание разрядов уже и есть округление.

В дополнительном коде смена знака — это инверсия плюс один; в сбалансированной троичной достаточно перевернуть каждый трит, и negate() спеки делает ровно это, разряд за разрядом. Отсечение k младших тритов даёт ближайшее кратное 3^k: 8 без одного трита — это 9, 7 — это 6. Ничьей быть не может: отброшенная часть всегда меньше половины шага, поэтому правило округления не нужно.

Попробовать

Нажмите переворот для 8 и для -121; затем отсеките у 13 один и два трита и сверьте каждый результат с ближайшим кратным.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Flip every trit to negate, cut trits to round
Flip every trit to negate, cut trits to round ↗

Negation in balanced ternary flips every trit: no borrow, no complement. Cutting the lowest trits rounds to the nearest multiple.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Переворот вместо минуса, отсечение вмест

Открыть спеку урока в плеере ↗

Все уроки

+

diff --git a/apps/website/public/ru/learn/folding-taps-onto-slices/index.html b/apps/website/public/ru/learn/folding-taps-onto-slices/index.html index dade06a53e..ee4bee15b3 100644 --- a/apps/website/public/ru/learn/folding-taps-onto-slices/index.html +++ b/apps/website/public/ru/learn/folding-taps-onto-slices/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Раскладка отводов по слайсам

Вы узнаете

Как симметрия и быстрый такт сокращают число слайсов DSP, нужных фильтру FIR.

У FIR с линейной фазой коэффициенты симметричны, поэтому предсумматор DSP48E1 может сложить два отсчёта с общим коэффициентом и умножить один раз: 31 отводу нужно 16 умножителей. Слайс, тактируемый C раз за отсчёт, может выполнить C из них один за другим, поэтому на 50 МГц при такте 200 МГц работу делают 4 слайса, а на 48 кГц всё делает один слайс. У XC7A200T 740 слайсов. Спека signals.t27 назначает каждый отвод его слайсу.

Попробовать

Сравните 31 отвод на 50 МГц с симметрией и без неё; затем поднимайте частоту дискретизации, пока каждый слайс не станет обслуживать один умножитель.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Folding a FIR onto DSP slices
Folding a FIR onto DSP slices ↗

Set taps, symmetry, clock and sample rate. Symmetric taps share a multiplier; a fast clock lets one slice serve many taps. See how many slices are left.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Раскладка отводов по слайсам

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/four-trit-exponent/index.html b/apps/website/public/ru/learn/four-trit-exponent/index.html index 99b1c02cae..f6bb6d1c8c 100644 --- a/apps/website/public/ru/learn/four-trit-exponent/index.html +++ b/apps/website/public/ru/learn/four-trit-exponent/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Число, у которого порядок — четыре трита

Вы узнаете

Как TNF17e упаковывает знак, тернарный порядок и мантиссу в 17 бит и почему 17, а не 16.

Имя TNF носят две разные вещи. В решете TNF(k, b) — алфавит весов с 3 или 9 уровнями. TNF17e в tnf17.t27 — Ternary Network Float, который спека называет знаковым форматом накопителя: бит знака, 7-битное смещение и 9-битная мантисса, а значение равно (-1)^s x (1 + m/512) x 2^(offset - 40). Его триты стоят в порядке, а не в весах: смещение принимает 81 значение, ровно 3^4, так что порядок — это четыре сбалансированных трита, от -40 до +40. Четыре трита стоят 7 бит на двоичном чипе, поэтому ступень занимает 17 бит, а не 16; спека записывает, что её источник считал позиции, а трит — не бит. Браузер выполняет 20 из 44 проверок, в том числе все 10 инвариантов, и у каждого пропуска называет приведение типа, которое не смог вычислить.

Попробуйте

Прочитайте причину у одного пропущенного теста; затем найдите инвариант, который говорит, что четыре трита дают 81 значение. В спеке у tnf16 тоже четыре трита порядка и сумма 16: найдите width_rule и прочитайте, что считает это 16 — биты или позиции.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tnf17.t27, a 17-bit ternary-exponent float, compiled inside the post
tnf17.t27, a 17-bit ternary-exponent float, compiled inside the post ↗

TNF17e as a t27 spec: a sign, a 7-bit offset holding four balanced trits, a 9-bit mantissa, compiled by t27c in your browser. Seven backends; every test the page cannot run says why.

specs/numeric/tnf16.t27

// SPDX-License-Identifier: Apache-2.0
@@ -140,6 +172,7 @@ 

Число, у которого порядок — четыре трита

Открыть спеку урока в плеере ↗

Все уроки

+ diff --git a/apps/website/public/ru/learn/fpga-is-a-grid/index.html b/apps/website/public/ru/learn/fpga-is-a-grid/index.html index 8d4a938e6e..8e0cdc7119 100644 --- a/apps/website/public/ru/learn/fpga-is-a-grid/index.html +++ b/apps/website/public/ru/learn/fpga-is-a-grid/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

FPGA — это сетка, которую вы настраиваете

Вы узнаете

Из чего состоит FPGA и почему дизайн занимает только часть чипа.

Процессор выполняет инструкции одну за другой. У FPGA программы нет вовсе: это сетка маленьких блоков — таблиц истинности (LUT), триггеров, цепочек переноса, блочной памяти и DSP-умножителей, — соединённых проводами, которые можно переключать. Настроив сетку, вы строите схему. Чип нашего стенда — AMD Artix-7 XC7A200T. Skyline рисует один оттрассированный дизайн на этом кристалле: каждый настроенный тайл встаёт столбиком, а большая часть чипа остаётся тёмной.

Попробуйте

Поверните кристалл и нажмите на самый высокий столбик: какой тип тайла задаёт больше всего фич? В спеке платы нашего стенда найдите LUT_TOTAL, затем инвариант про DSP48E1_TOTAL: что, судя по его имени, используют наши ядра?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

FASM skyline: a routed 7-series design as a city on the XC7A200T die
FASM skyline: a routed 7-series design as a city on the XC7A200T die ↗

Drop a .fasm: every tile it configures becomes a column as tall as the features it sets, on the full XC7A200T grid. Counted in your browser; PNG to share.

specs/boards/wukong_v1.t27

// SPDX-License-Identifier: Apache-2.0
@@ -365,6 +397,7 @@ 

FPGA — это сетка, которую вы настраиваете

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/frames-and-the-fcs/index.html b/apps/website/public/ru/learn/frames-and-the-fcs/index.html index e1734a96f8..7b9cb7b730 100644 --- a/apps/website/public/ru/learn/frames-and-the-fcs/index.html +++ b/apps/website/public/ru/learn/frames-and-the-fcs/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Кадры и контрольная сумма

Вы узнаете

Как кадр Ethernet заканчивается CRC-32 и что вычисляет проверка.

Кадр Ethernet заканчивается контрольной суммой кадра: CRC-32 по байтам, вычисленная отправителем и пересчитанная получателем. Спека этого урока, написанная для этого курса, несёт полином и арифметику, а её заголовок помечает, на что проверка претендует и на что нет. Запись прогоняет t27c по ней.

Попробовать

В записи проследите прогон; затем в спеке найдите полином, который использует CRC-32, и что заголовок помечает как допущение.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on eth_crc.t27 -- the FCS, native
t27c on eth_crc.t27 -- the FCS, native ↗

t27c test-report on the Ethernet frame check sequence: 8 tests pass natively -- the table derived from one bit step, the check value 0xCBF43926, and the receiver residue 0xDEBB20E3.

specs/fpga/eth_crc.t27

// SPDX-License-Identifier: Apache-2.0
@@ -297,6 +329,7 @@ 

Кадры и контрольная сумма

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/framing-a-conversation/index.html b/apps/website/public/ru/learn/framing-a-conversation/index.html index 132cb66685..190db6ab1e 100644 --- a/apps/website/public/ru/learn/framing-a-conversation/index.html +++ b/apps/website/public/ru/learn/framing-a-conversation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Кадрирование разговора

Вы узнаете

Что меняет разговор под тактом и как спека SPI описывает свои режимы и частоты.

Разговору нужны правила, когда начинается и заканчивается слово, — иначе дальняя сторона считывает шум. Ответ под тактом — SPI, и спека этого урока, SPI_Master, заявляет основу: CLK_FREQ равен 50,000,000, SPI_CPOL и SPI_CPHA равны 0, максимальная ширина данных 32 бита. Запись прогоняет t27c check: 0 ошибок, 0 предупреждений. Три шины, которые открывает этот модуль, — UART, SPI и APB — это три ответа, которые курс разбирает по модулям.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите CLK_FREQ, CPOL и CPHA и скажите, какой режим конфигурирует спека.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c check on spi.t27 -- the spec compiles
t27c check on spi.t27 -- the spec compiles ↗

t27c check typechecks the SPI spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/spi.t27

// SPDX-License-Identifier: Apache-2.0
@@ -474,6 +506,7 @@ 

Кадрирование разговора

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/fsm-coverage/index.html b/apps/website/public/ru/learn/fsm-coverage/index.html index 941aad9564..637eb8ecfe 100644 --- a/apps/website/public/ru/learn/fsm-coverage/index.html +++ b/apps/website/public/ru/learn/fsm-coverage/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Покрытие автоматов

Вы научитесь

Как покрытие состояний и переходов видит дуги, по которым прогон так и не прошёл.

Автомат проверяется дугами, а не состояниями: 4 состояния с 12 переходами — это 12 способов ошибиться, и обход всех состояний может оставить половину дуг холодными. Spec моделирует это прямо: точки состояний и точки переходов, каждая со счётчиком, и запретные переходы, ломающие отчёт в тот момент, когда хоть один согреется. Виджет — та же дисциплина в другой форме: 112 файлов закреплены в spec по sha256, каждый учтён — 0 потеряно, 0 не сохранено, 0 не найдено. Ничему в списке не разрешено остаться непосещённым.

Попробуйте

Перечислите дуги автомата FIFO из 4 состояний и отметьте, какие оставит холодными нагрузка только на чтение; затем найдите в spec запретные дуги и то, что их согревает.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-tmpcheck · every /tmp file a spec pins, kept
tri fpga-tmpcheck · every /tmp file a spec pins, kept ↗

112 files under /tmp are pinned by sha256 in specs. /tmp is emptied at boot and all 112 are gone from it; every one has a kept copy. 0 lost, 0 not kept, 0 unlocated.

specs/fpga/coverage.t27

// SPDX-License-Identifier: Apache-2.0
@@ -574,6 +606,7 @@ 

Покрытие автоматов

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/full-adder/index.html b/apps/website/public/ru/learn/full-adder/index.html index 43ea5298dc..9519bc4c29 100644 --- a/apps/website/public/ru/learn/full-adder/index.html +++ b/apps/website/public/ru/learn/full-adder/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Полный сумматор

Вы узнаете

Почему три трита всё ещё умещаются в один трит суммы и один трит переноса.

Полный сумматор добавляет перенос из младшего разряда. Три трита в сумме дают -3..3, и этот отрезок всегда равен 3 x carry + sum, где оба — одиночные триты; тест спеки проверяет все 27 случаев. Спека урока в плеере — другая машина: ternary_full_adder.t27 строит двоичный полный сумматор из троичных нейронов, как это делает работа репозитория с BitNet на FPGA. Одно слово, два смысла, и оба запускаются.

Попробовать

Поставьте все три входа в +1, затем в -1; прочитайте перенос и сумму и найдите случай, где перенос равен 0, хотя ни один вход не 0.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The full adder: a carry comes in, a carry goes out
The full adder: a carry comes in, a carry goes out ↗

Add a carry from the place below. Three trits sum to -3..3, still one sum trit and one carry trit: 27 cases, every one shown.

specs/ternary/ternary_full_adder.t27

module TernaryFullAdder;
@@ -146,6 +178,7 @@ 

Полный сумматор

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/functions/index.html b/apps/website/public/ru/learn/functions/index.html index 3469b4538b..6563b1206c 100644 --- a/apps/website/public/ru/learn/functions/index.html +++ b/apps/website/public/ru/learn/functions/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Функции

Вы узнаете

Два способа записать сигнатуру функции в t27 и тело с return.

fn add(a: u8, b: u8) -> u8 объявляет функцию с двумя входами u8 и результатом u8; тело в фигурных скобках заканчивается return. Компилятор принимает и стиль Zig, pub fn add(a: u8, b: u8) u8, без стрелки. Обобщений нет: fn id<T> — ошибка разбора. Тестовый прогон этого сайта проверяет константы и не вызывает функции, поэтому урок держит ожидаемые результаты константами рядом с ними.

Попробуйте

Напишите в плеере функцию sub в любом из двух стилей и проверьте, что вердикт чистый.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 12: a function signature, piece by piece
t27 basics 12: a function signature, piece by piece ↗

The pieces of a t27 function signature in both styles the compiler accepts, and the generics it does not. Lesson 12 of the t27 basics course.

specs/basics/12_functions.t27

// SPDX-License-Identifier: Apache-2.0
@@ -87,6 +119,7 @@ 

Функции

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gated-clock-trap/index.html b/apps/website/public/ru/learn/gated-clock-trap/index.html index 11bce009f7..7e49a66f9b 100644 --- a/apps/website/public/ru/learn/gated-clock-trap/index.html +++ b/apps/website/public/ru/learn/gated-clock-trap/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Ловушка стробированного клока

Вы узнаете

Почему стробирование клока логикой создаёт новый домен и зачем нужен clock enable.

Стробировать клок логикой — элемент AND на линии тактового сигнала ради экономии — значит резать клок сигналом, который меняется со скоростью данных: получаются глитчи, и тихо возникает новый тактовый домен из всего, что ниже по потоку. Правило: не стробируйте клок; используйте clock enable — его сэмплирует триггер на фронте, а не фронт сэмплирует его. Виджет показывает дисциплину доказательства таких утверждений: два битстрима, различающихся в трёх битах, и выбивающая сборка на каждый бит, каждая снимает один — ни один бит не может приписать себе незаслуженную заслугу. Окно спеки открывает clock_domain.t27, чей тип источника gated_clk — модель этой ловушки.

Попробуйте

В виджете найдите, на сколько бит различаются битстримы и как снимали каждый; затем в окне спеки найдите тип источника gated-clock и значение перечисления стратегий, которое вынуждает стробированный клок.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Race the bee: who lands patches on t27, a person or a bee
Race the bee: who lands patches on t27, a person or a bee ↗

A dated snapshot of gHashTag/t27: merged pull requests by the Queen's bees and by people, the issues both lanes went for, and the open ones nobody has taken.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

Ловушка стробированного клока

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gelu/index.html b/apps/website/public/ru/learn/gelu/index.html index c153a8ff92..6d918dc696 100644 --- a/apps/website/public/ru/learn/gelu/index.html +++ b/apps/website/public/ru/learn/gelu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GELU: провал ниже нуля

Вы узнаете

Что вычисляет GELU, почему она проваливается ниже нуля и насколько близко подходит её приближение через tanh.

GELU взвешивает x вероятностью того, что стандартная нормальная величина меньше него: GELU(x) = x Phi(x). Большой положительный вход проходит, большой отрицательный исчезает, а между ними кривая проваливается примерно до -0.17 около x = -0.75 и только потом растёт. BERT и GPT используют её в своих слоях прямого распространения. Точной форме нужна erf, и спека вычисляет её приближением Абрамовица-Стиган с точностью 1.5e-7, а также вычисляет приближение через tanh: при -0.75 они дают -0.16997 и -0.17004. Спека gelu_activation.t27 вычисляет обе кривые и их наклоны.

Попробовать

Найдите нижнюю точку кривой по её наклону; затем сравните точную форму и форму через tanh при -3.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GELU: why transformers bend a little below zero
GELU: why transformers bend a little below zero ↗

Drag along GELU: x weighed by the chance a normal draw is below it. It dips to about -0.17 before it rises, and the tanh shortcut stays within a few thousandths of the exact form.

specs/ml/activation/gelu_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -235,6 +267,7 @@ 

GELU: провал ниже нуля

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gen-ts/index.html b/apps/website/public/ru/learn/gen-ts/index.html index 5b16bd1b4a..b983c57428 100644 --- a/apps/website/public/ru/learn/gen-ts/index.html +++ b/apps/website/public/ru/learn/gen-ts/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

gen-ts: спека превращается в TypeScript

Вы узнаете

Что gen-ts пишет для констант и функций и как это использует программа-хозяин.

t27c gen-ts превращает каждую константу в строку export const, которую проверяет TypeScript. Функции не выводятся: бэкенд говорит, что переносит объявления, а не тела. Так этот сайт и пользуется спеками: генератор читает файл .t27 и пишет числа и слова, которые импортирует страница. Таблица под уроком показывает, что gen-ts написал для спеки урока.

Попробуйте

Добавьте константу в спеку урока в плеере и найдите её строку во вкладке ts.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 21: what gen-ts writes
t27 basics 21: what gen-ts writes ↗

The TypeScript the real t27 compiler wrote for the lesson spec, line by line next to its source. Lesson 21 of the t27 basics course.

specs/basics/21_gen_ts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -84,6 +116,7 @@ 

gen-ts: спека превращается в TypeScript

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf10-ten-bits/index.html b/apps/website/public/ru/learn/gf10-ten-bits/index.html index 1c081ca0e6..895b64dec9 100644 --- a/apps/website/public/ru/learn/gf10-ten-bits/index.html +++ b/apps/website/public/ru/learn/gf10-ten-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF10: десять битов

Вы узнаете

Как 10 битов делятся на 1 + 3 + 6 и почему его отношение стоит в 0.118 от 1 / phi.

В GF10 10 битов: 1 знак, 3 порядка, 6 мантиссы, смещение 3. Правило даёт E = round(9 / phi^2) = 3, а E / M равно 0.5, на том же расстоянии 0.118 от 1 / phi, что и у GF4. Платой служит округление до целых битов: на малых ширинах выбирать почти не из чего.

Попробуйте

Найдите EM_RATIO и PHI_DIST в gf10.t27. Затем посчитайте round(9 / phi^2) сами и сверьте с EXP_BITS.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 10: GF10, ten bits
GoldenFloat 10: GF10, ten bits ↗

GF10: 10 bits as the spec lays them out, read from gf10.t27. Lesson 10 of the GoldenFloat course.

specs/numeric/gf10.t27

// SPDX-License-Identifier: Apache-2.0
@@ -152,6 +184,7 @@ 

GF10: десять битов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf1024-one-kilobit/index.html b/apps/website/public/ru/learn/gf1024-one-kilobit/index.html index 70377342c0..96d326d438 100644 --- a/apps/website/public/ru/learn/gf1024-one-kilobit/index.html +++ b/apps/website/public/ru/learn/gf1024-one-kilobit/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF1024: один килобит

Вы узнаете

Самая широкая ступень семейства, 1 + 391 + 632, и тест, который её называет.

В GF1024 1024 бита: 1 знак, 391 порядка, 632 мантиссы. Его отношение E / M равно 0.6187, на расстоянии 0.0006 от 1 / phi, и в спеке семейства есть тест, который называет GF1024 форматом с наименьшим расстоянием до phi. Это ступень семейства на бумаге; никакое железо в этом курсе на нём не считает.

Попробуйте

Найдите PHI_DIST в gf1024.t27. Затем в goldenfloat_family.t27 найдите тест про GF1024 и функцию, которую он вызывает.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 23: GF1024, one kilobit
GoldenFloat 23: GF1024, one kilobit ↗

GF1024: 1024 bits as the spec lays them out, read from gf1024.t27. Lesson 23 of the GoldenFloat course.

specs/numeric/gf1024.t27

// SPDX-License-Identifier: Apache-2.0
@@ -150,6 +182,7 @@ 

GF1024: один килобит

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf12-twelve-bits/index.html b/apps/website/public/ru/learn/gf12-twelve-bits/index.html index 9d71209c3b..321cc821cf 100644 --- a/apps/website/public/ru/learn/gf12-twelve-bits/index.html +++ b/apps/website/public/ru/learn/gf12-twelve-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF12: двенадцать битов

Вы узнаете

GoldenFloat в двенадцать битов, 1 + 4 + 7, смещение 7, и как имя теста может обещать больше, чем его проверка.

gf12.t27 держит 12 битов: 1 бит знака, 4 бита порядка, 7 битов мантиссы и смещение 7. Его отношение E / M равно 4 / 7 = 0.571, а PHI_DISTANCE равно 0.0466. Тест, который это проверяет, называется gf12_phi_distance_lowest, но утверждает лишь, что расстояние меньше 0.05, а комментарий в спеке называет GF12 ближайшим из всех форматов. Семейство говорит иначе: GF14 в следующем уроке стоит в 0.007 от 1 / phi, а GF32 в 0.0135. Читайте тест по его assert, а не по имени. MEMORY_RATIO_VS_FP32 равно 12 / 32 = 0.375.

Попробуйте

Найдите PHI_DISTANCE и тест gf12_phi_distance_lowest в gf12.t27. Затем сравните расстояние с GF14 и GF32 и скажите, что обещает имя теста, чего не проверяет его assert.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 11: GF12, twelve bits
GoldenFloat 11: GF12, twelve bits ↗

GF12: 12 bits as the spec lays them out, read from gf12.t27. Lesson 11 of the GoldenFloat course.

specs/numeric/gf12.t27

// SPDX-License-Identifier: Apache-2.0
@@ -560,6 +592,7 @@ 

GF12: двенадцать битов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf128-a-quad/index.html b/apps/website/public/ru/learn/gf128-a-quad/index.html index ad6e99a17b..815cd57922 100644 --- a/apps/website/public/ru/learn/gf128-a-quad/index.html +++ b/apps/website/public/ru/learn/gf128-a-quad/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF128: четверная точность

Вы узнаете

128-битный GoldenFloat, 1 + 49 + 78, и четыре инварианта, которые держат его раскладку.

В GF128 128 битов: 1 знак, 49 порядка, 78 мантиссы. Четверная точность IEEE тратит на порядок 15 битов. Спека держит раскладку четырьмя инвариантами: поля делят слово целиком, мантисса и порядок следуют замкнутой формуле, сдвиги следуют раскладке.

Попробуйте

Прочитайте четыре инварианта gf128.t27 и проверьте SIGN_SHIFT и EXP_SHIFT по ширинам полей вручную.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 20: GF128, a quad
GoldenFloat 20: GF128, a quad ↗

GF128: 128 bits as the spec lays them out, read from gf128.t27. Lesson 20 of the GoldenFloat course.

specs/numeric/gf128.t27

// SPDX-License-Identifier: Apache-2.0
@@ -144,6 +176,7 @@ 

GF128: четверная точность

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf14-fourteen-bits/index.html b/apps/website/public/ru/learn/gf14-fourteen-bits/index.html index b0443dd623..688d639887 100644 --- a/apps/website/public/ru/learn/gf14-fourteen-bits/index.html +++ b/apps/website/public/ru/learn/gf14-fourteen-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF14: четырнадцать битов

Вы узнаете

Как 14 битов делятся на 1 + 5 + 8, отношение в 0.007 от 1 / phi.

В GF14 14 битов: 1 знак, 5 порядка, 8 мантиссы, смещение 15. Его отношение E / M равно 0.625, всего в 0.007 от 1 / phi, потому что 5 и 8 — соседние числа Фибоначчи, а отношение соседей приближается к 1 / phi.

Попробуйте

Найдите PHI_DIST в gf14.t27 и сравните с GF10. Затем назовите следующую пару чисел Фибоначчи после 5 и 8.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 12: GF14, fourteen bits
GoldenFloat 12: GF14, fourteen bits ↗

GF14: 14 bits as the spec lays them out, read from gf14.t27. Lesson 12 of the GoldenFloat course.

specs/numeric/gf14.t27

// SPDX-License-Identifier: Apache-2.0
@@ -152,6 +184,7 @@ 

GF14: четырнадцать битов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf16-the-primary/index.html b/apps/website/public/ru/learn/gf16-the-primary/index.html index 0662dca1a0..31cbfb60a8 100644 --- a/apps/website/public/ru/learn/gf16-the-primary/index.html +++ b/apps/website/public/ru/learn/gf16-the-primary/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF16: основной формат

Вы узнаете

GoldenFloat на 16 битов, который семейство отмечает основным: 1 + 6 + 9, смещение 31 и его особые коды.

В GF16 16 битов: 1 знак, 6 порядка, 9 мантиссы, смещение 31. Код порядка 63, все единицы, оставлен для бесконечности и NaN, как в IEEE 754. Спека даёт имя каждому особому коду: 0x0000 и 0x8000 для двух нулей, 0x7E00 и 0xFE00 для двух бесконечностей, 0xFE01 для NaN. Мантисса из 9 битов делится на 512.

Попробуйте

Найдите SIGN_MASK, EXP_MASK и MANT_MASK в gf16.t27 и проверьте, что вместе они покрывают все 16 битов. Затем найдите код NaN и скажите, какое поле отличает его от бесконечности.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 13: GF16, the primary format
GoldenFloat 13: GF16, the primary format ↗

GF16 special codes, read from gf16.t27. Lesson 13 of the GoldenFloat course.

specs/numeric/gf16.t27

// SPDX-License-Identifier: Apache-2.0
@@ -3861,6 +3893,7 @@ 

GF16: основной формат

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf24-twenty-four-bits/index.html b/apps/website/public/ru/learn/gf24-twenty-four-bits/index.html index fcf01d5541..1ed1ccc2e9 100644 --- a/apps/website/public/ru/learn/gf24-twenty-four-bits/index.html +++ b/apps/website/public/ru/learn/gf24-twenty-four-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF20 и GF24

Вы узнаете

GoldenFloat в 20 и 24 бита, 1 + 7 + 12 и 1 + 9 + 14, и допуск, который даёт каждая спека.

gf20.t27 держит 1 бит знака, 7 битов порядка и 12 битов мантиссы со смещением 63; gf24.t27 держит 1 бит знака, 9 битов порядка и 14 битов мантиссы со смещением 255. Урок открывает gf24.t27: его PHI_DISTANCE равно 0.0248, а тест пропускает всё меньше 0.03; MEMORY_RATIO_VS_FP32 равно 0.75. GF20 записывает своё расстояние как 0.03463 при границе теста 0.04, тогда как 7 / 12 стоит в 0.03470 от 1 / phi: записанная константа и арифметика расходятся в четвёртом знаке. Обе ширины держат отношение в пределах 0.035 от 1 / phi.

Попробуйте

Найдите PHI_DISTANCE и EXP_BIAS в gf24.t27 и проверьте смещение по 2^(9 - 1) - 1. Затем посчитайте 7 / 12 против 0.618034 и сравните с константой, которую хранит gf20.t27.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 15: GF20 and GF24
GoldenFloat 15: GF20 and GF24 ↗

GF24: 24 bits as the spec lays them out, beside GF20, read from gf24.t27. Lesson 15 of the GoldenFloat course.

specs/numeric/gf24.t27

// SPDX-License-Identifier: Apache-2.0
@@ -547,6 +579,7 @@ 

GF20 и GF24

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf256-two-five-six/index.html b/apps/website/public/ru/learn/gf256-two-five-six/index.html index 2b6125cab0..00525f99e1 100644 --- a/apps/website/public/ru/learn/gf256-two-five-six/index.html +++ b/apps/website/public/ru/learn/gf256-two-five-six/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF256: двести пятьдесят шесть битов

Вы узнаете

Как правило делит 256 битов на 1 + 97 + 158.

В GF256 256 битов: 1 знак, 97 порядка, 158 мантиссы. В спеке семейства есть тест и на эти числа. На такой ширине округление почти ничего не стоит, и отношение E / M равно 0.614, в 0.004 от 1 / phi.

Попробуйте

Найдите EM_RATIO и PHI_DIST в gf256.t27. Затем в goldenfloat_family.t27 найдите тест, который проверяет числа битов GF256, и проверьте, что обе спеки согласны.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 21: GF256
GoldenFloat 21: GF256 ↗

GF256: 256 bits as the spec lays them out, read from gf256.t27. Lesson 21 of the GoldenFloat course.

specs/numeric/gf256.t27

// SPDX-License-Identifier: Apache-2.0
@@ -144,6 +176,7 @@ 

GF256: двести пятьдесят шесть битов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf32-a-single/index.html b/apps/website/public/ru/learn/gf32-a-single/index.html index 4375ab39ef..e7c6731cf8 100644 --- a/apps/website/public/ru/learn/gf32-a-single/index.html +++ b/apps/website/public/ru/learn/gf32-a-single/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF32: одинарная точность

Вы узнаете

GoldenFloat в 32 бита, 1 + 12 + 19, смещение 2047, и два инварианта, которые сравнивают его с IEEE single.

gf32.t27 держит 32 бита: 1 бит знака, 12 битов порядка, 19 битов мантиссы и смещение 2047. IEEE single тратит 8 битов на порядок и 23 на мантиссу; спека держит два инварианта, которые это говорят, EXP_BITS > 8 и MANT_BITS < 23, так что GF32 при той же ширине меняет точность на диапазон. Его PHI_DISTANCE равно 0.0135, ниже границы теста 0.015, а MEMORY_RATIO_VS_FP32 равно 1. Комментарий называет GF32 вторым после GF12; по расстояниям этого курса он ближе, чем GF12, а GF14 ещё ближе.

Попробуйте

Найдите два инварианта gf32.t27, которые сравнивают его с IEEE single. Затем проверьте EXP_BIAS по 2^(12 - 1) - 1 и посчитайте 12 / 19.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 16: GF32, a single
GoldenFloat 16: GF32, a single ↗

GF32: 32 bits as the spec lays them out, beside IEEE single, read from gf32.t27. Lesson 16 of the GoldenFloat course.

specs/numeric/gf32.t27

// SPDX-License-Identifier: Apache-2.0
@@ -558,6 +590,7 @@ 

GF32: одинарная точность

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf4-four-bits/index.html b/apps/website/public/ru/learn/gf4-four-bits/index.html index 0be23877e6..fac18eb47a 100644 --- a/apps/website/public/ru/learn/gf4-four-bits/index.html +++ b/apps/website/public/ru/learn/gf4-four-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF4: четыре бита

Вы узнаете

Самый маленький GoldenFloat: один бит знака, один бит порядка, два бита мантиссы, смещение 0.

В GF4 4 бита: 1 знак, 1 порядок, 2 мантиссы, и смещение порядка равно 0. С одним битом порядка есть только два масштаба, 1 и 2, поэтому его 16 кодов грубые. Правило даёт E = round(3 / phi^2) = 1, а отношение E / M равно 0.5, на 0.118 от 1 / phi. Курс «ИИ-числа» открывает ту же спеку по другой причине; здесь это нижняя ступень семейства.

Попробуйте

Найдите EXP_BIAS и PHI_DISTANCE в gf4.t27, затем инвариант, который ограничивает расстояние. Откройте функцию decode и найдите два масштаба, которые даёт один бит порядка.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 7: GF4, four bits
GoldenFloat 7: GF4, four bits ↗

GF4: 4 bits as the spec lays them out, read from gf4.t27. Lesson 7 of the GoldenFloat course.

specs/numeric/gf4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -373,6 +405,7 @@ 

GF4: четыре бита

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf48-forty-eight-bits/index.html b/apps/website/public/ru/learn/gf48-forty-eight-bits/index.html index 476af4d056..c34c39b7dd 100644 --- a/apps/website/public/ru/learn/gf48-forty-eight-bits/index.html +++ b/apps/website/public/ru/learn/gf48-forty-eight-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF48: сорок восемь битов

Вы узнаете

Как правило делит 48 битов на 1 + 18 + 29, ширину, которой нет в IEEE 754.

В GF48 48 битов: 1 знак, 18 порядка, 29 мантиссы, смещение 131071. В IEEE 754 нет 48-битного формата; правило строит его так же, как все остальные. Его отношение E / M равно 0.621, в 0.003 от 1 / phi.

Попробуйте

Найдите BIAS и EXP_MAX в gf48.t27 и сверьте с 2^17 - 1 и 2^18 - 1. Затем найдите три константы сдвига и скажите, какое поле ставит каждая.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 17: GF48, forty-eight bits
GoldenFloat 17: GF48, forty-eight bits ↗

GF48: 48 bits as the spec lays them out, read from gf48.t27. Lesson 17 of the GoldenFloat course.

specs/numeric/gf48.t27

// SPDX-License-Identifier: Apache-2.0
@@ -152,6 +184,7 @@ 

GF48: сорок восемь битов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf512-five-twelve/index.html b/apps/website/public/ru/learn/gf512-five-twelve/index.html index 57238e3adb..8d514229ab 100644 --- a/apps/website/public/ru/learn/gf512-five-twelve/index.html +++ b/apps/website/public/ru/learn/gf512-five-twelve/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF512: пятьсот двенадцать битов

Вы узнаете

Как правило делит 512 битов на 1 + 195 + 316, отношение в пределах 0.001 от 1 / phi.

В GF512 512 битов: 1 знак, 195 порядка, 316 мантиссы. Его отношение E / M равно 0.617, меньше чем в 0.001 от 1 / phi. Чем шире слово, тем ближе целые биты могут подойти к цели, и таблица семейства это показывает.

Попробуйте

Найдите PHI_DIST в gf512.t27 и сравните с GF14 и GF48. Затем проверьте SIGN_SHIFT и EXP_SHIFT вручную.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 22: GF512
GoldenFloat 22: GF512 ↗

GF512: 512 bits as the spec lays them out, read from gf512.t27. Lesson 22 of the GoldenFloat course.

specs/numeric/gf512.t27

// SPDX-License-Identifier: Apache-2.0
@@ -145,6 +177,7 @@ 

GF512: пятьсот двенадцать битов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf6-six-bits/index.html b/apps/website/public/ru/learn/gf6-six-bits/index.html index 2b88bc46d1..e4708e96a6 100644 --- a/apps/website/public/ru/learn/gf6-six-bits/index.html +++ b/apps/website/public/ru/learn/gf6-six-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF6: шесть битов

Вы узнаете

Как правило делит 6 битов на 1 + 2 + 3 и что значит смещение 1.

В GF6 6 битов: 1 знак, 2 порядка, 3 мантиссы. Два бита порядка дают коды от 0 до 3, и со смещением 1 масштаб идёт от 2^-1 до 2^2. Отношение E / M равно 0.667, на 0.049 от 1 / phi. В спеке есть и строка статуса: смещение не выводится из замкнутой формулы, оно выбирается для каждого формата, и спека так и пишет.

Попробуйте

Найдите BIAS и EXP_MAX в gf6.t27 и сверьте их с 2^(E-1) - 1 и 2^E - 1. Затем прочитайте PHI_BIAS_STATUS и скажите, что он признаёт.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 8: GF6, six bits
GoldenFloat 8: GF6, six bits ↗

GF6: 6 bits as the spec lays them out, read from gf6.t27. Lesson 8 of the GoldenFloat course.

specs/numeric/gf6.t27

// SPDX-License-Identifier: Apache-2.0
@@ -152,6 +184,7 @@ 

GF6: шесть битов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf64-a-double/index.html b/apps/website/public/ru/learn/gf64-a-double/index.html index 0e24fa0ad6..04a7d6eb8e 100644 --- a/apps/website/public/ru/learn/gf64-a-double/index.html +++ b/apps/website/public/ru/learn/gf64-a-double/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF64: двойная точность

Вы узнаете

64-битный GoldenFloat, 1 + 24 + 39, рядом с двойной точностью IEEE, и как его кодировщик ограничивает порядок.

В GF64 64 бита: 1 знак, 24 порядка, 39 мантиссы, смещение 8388607. Двойная точность IEEE тратит 11 битов на порядок и 52 на мантиссу; GF64 меняет мантиссу на гораздо более широкий диапазон. В его спеке есть кодировщик и декодер: мантисса делится на 2^39, а порядок ограничен между 0 и 2^24 - 1.

Попробуйте

Найдите EXP_BIAS, EXP_MAX и MANT_DIV в gf64.t27. Затем откройте encode и найдите, где ограничивается порядок.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 18: GF64, a double
GoldenFloat 18: GF64, a double ↗

GF64: 64 bits as the spec lays them out, read from gf64.t27. Lesson 18 of the GoldenFloat course.

specs/numeric/gf64.t27

// SPDX-License-Identifier: Apache-2.0
@@ -296,6 +328,7 @@ 

GF64: двойная точность

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf8-one-byte/index.html b/apps/website/public/ru/learn/gf8-one-byte/index.html index 47897c15cd..faa4024fd0 100644 --- a/apps/website/public/ru/learn/gf8-one-byte/index.html +++ b/apps/website/public/ru/learn/gf8-one-byte/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF8: один байт

Вы узнаете

GoldenFloat в один байт, 1 + 3 + 4, смещение 3, и каковы его наибольшее и наименьшее значения.

gf8.t27 держит один байт: 1 бит знака, 3 бита порядка, 4 бита мантиссы и смещение 3, то есть 2^(3 - 1) - 1. PHI_DISTANCE равно 0.132 — это дальше всех из семи ширин, что перечисляет phi_ratio.t27, ведь 3 / 4 = 0.75 перелетает 1 / phi. Наибольшее значение, по max_value, равно (1 + 15/16) * 2^(7 - 3) = 31, а наименьшее, по min_positive, 1/16 * 2^-2 = 1/64. Комментарии над обеими функциями говорят 15.5 и 0.0625; код считает 31 и 1/64. MEMORY_RATIO_VS_FP32 равно 0.25: четыре значения GF8 помещаются там, где одно FP32.

Попробуйте

Посчитайте max_value и min_positive из gf8.t27 вручную и сравните с комментариями над ними. Затем декодируйте код 0b01000000, который тест gf8_phi_distance ждёт для phi, и скажите, какое значение в нём.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 9: GF8, one byte
GoldenFloat 9: GF8, one byte ↗

GF8: 8 bits as the spec lays them out, read from gf8.t27. Lesson 9 of the GoldenFloat course.

specs/numeric/gf8.t27

// SPDX-License-Identifier: Apache-2.0
@@ -596,6 +628,7 @@ 

GF8: один байт

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gf96-ninety-six-bits/index.html b/apps/website/public/ru/learn/gf96-ninety-six-bits/index.html index c0d686b325..04c3c513fa 100644 --- a/apps/website/public/ru/learn/gf96-ninety-six-bits/index.html +++ b/apps/website/public/ru/learn/gf96-ninety-six-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF96: девяносто шесть битов

Вы узнаете

Почему спека 96-битного числа записывает смещение выражением, а не числом.

В GF96 96 битов: 1 знак, 36 порядка, 59 мантиссы. Его смещение, 2^35 - 1, уже не помещается в 64-битные целые, которыми спека пользуется для малых форматов, поэтому спека пишет его текстом 2^(36-1) - 1 и проверяет раскладку инвариантами. Отношение E / M равно 0.610.

Попробуйте

Найдите BIAS_EXPR и EXP_MAX_EXPR в gf96.t27 и сравните с BIAS в gf48.t27. Затем прочитайте инварианты и скажите, что проверяет каждый.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 19: GF96, ninety-six bits
GoldenFloat 19: GF96, ninety-six bits ↗

GF96: 96 bits as the spec lays them out, read from gf96.t27. Lesson 19 of the GoldenFloat course.

specs/numeric/gf96.t27

// SPDX-License-Identifier: Apache-2.0
@@ -144,6 +176,7 @@ 

GF96: девяносто шесть битов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gft16-six-trits/index.html b/apps/website/public/ru/learn/gft16-six-trits/index.html index 167bfbfe9c..b2d3013ac9 100644 --- a/apps/website/public/ru/learn/gft16-six-trits/index.html +++ b/apps/website/public/ru/learn/gft16-six-trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF-T16: шесть тритов

Вы узнаете

Как GF-T16 тратит 6 тритов порядка и 9 битов мантиссы и сколько значений порядка это даёт.

В GF-T16 1 знак, 6 тритов порядка и 9 битов мантиссы. Шесть тритов дают 3^6 = 729 значений порядка; смещение 364 балансирует их, а смещение 728 не конечно. Деление в тысячных: 6000 / 9 = 666. Мантисса у него те же 9 битов, что у GF16, так что они различаются только тем, как хранят порядок.

Попробуйте

Запустите два теста gft16.t27. Затем сравните MANT_BITS с GF16 и посчитайте, какой диапазон вокруг нуля покрывают 729 значений порядка.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 25: GF-T16, six trits
GoldenFloat 25: GF-T16, six trits ↗

GF-T16 as the spec lays it out, read from gft16.t27. Lesson 25 of the GoldenFloat course.

specs/numeric/gft16.t27

// SPDX-License-Identifier: Apache-2.0
@@ -123,6 +155,7 @@ 

GF-T16: шесть тритов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gft32-twelve-trits/index.html b/apps/website/public/ru/learn/gft32-twelve-trits/index.html index 42134717c5..373c08cb14 100644 --- a/apps/website/public/ru/learn/gft32-twelve-trits/index.html +++ b/apps/website/public/ru/learn/gft32-twelve-trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF-T32: двенадцать тритов

Вы узнаете

Как GF-T32 тратит 12 тритов порядка и 19 битов мантиссы.

В GF-T32 1 знак, 12 тритов порядка и 19 битов мантиссы. Двенадцать тритов дают 3^12 = 531441 значение порядка; смещение 265720 балансирует их, а смещение 531440 не конечно. Деление в тысячных: 12000 / 19 = 631. 19 битов мантиссы совпадают с GF32 в таблице семейства.

Попробуйте

Запустите два теста gft32.t27 и проверьте 3^12 вручную. Затем сравните его мантиссу со строкой GF32 в спеке семейства.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 26: GF-T32, twelve trits
GoldenFloat 26: GF-T32, twelve trits ↗

GF-T32 as the spec lays it out, read from gft32.t27. Lesson 26 of the GoldenFloat course.

specs/numeric/gft32.t27

// SPDX-License-Identifier: Apache-2.0
@@ -123,6 +155,7 @@ 

GF-T32: двенадцать тритов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gft8-exponent-in-trits/index.html b/apps/website/public/ru/learn/gft8-exponent-in-trits/index.html index bd3945a2fe..5ce2a4c50a 100644 --- a/apps/website/public/ru/learn/gft8-exponent-in-trits/index.html +++ b/apps/website/public/ru/learn/gft8-exponent-in-trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

GF-T8: порядок в тритах

Вы узнаете

Как GF-T сохраняет деление по phi, но хранит порядок в сбалансированных тритах: 1 + 3 трита + 4 бита.

GF-T — это GoldenFloat с троичным порядком. В GF-T8 1 знак, 3 трита порядка и 4 бита мантиссы. Три трита дают 27 значений порядка, смещение 13 делает их сбалансированными вокруг нуля, а смещение 26 оставлено как особое неконечное значение. Спека проверяет деление как E / M в тысячных: 3000 / 4 = 750.

Попробуйте

Запустите два теста gft8.t27. Затем найдите exp_values и is_finite и скажите, какое смещение не конечно.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 24: GF-T8, an exponent in trits
GoldenFloat 24: GF-T8, an exponent in trits ↗

GF-T8 as the spec lays it out, read from gft8.t27. Lesson 24 of the GoldenFloat course.

specs/numeric/gft8.t27

// SPDX-License-Identifier: Apache-2.0
@@ -123,6 +155,7 @@ 

GF-T8: порядок в тритах

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/global-buffers/index.html b/apps/website/public/ru/learn/global-buffers/index.html index 668b754873..389c3bcfde 100644 --- a/apps/website/public/ru/learn/global-buffers/index.html +++ b/apps/website/public/ru/learn/global-buffers/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Глобальный буфер

Вы узнаете

Что такое глобальный буфер, почему он живёт в собственной сети и как выглядела одна настоящая сборка всего потока.

Глобальный буфер, BUFG на кристалле 7-й серии, ведёт тактовый сигнал по выделенной малоперекосной сети, чтобы у дерева из прошлого урока был чистый корень. Виджет показывает поток, внутри которого стоит BUFG: одна настоящая сборка XC7A200T — 116,9 с с openXC7 и 83,5 с через путь t27 L3+L4, побайтово одинаковые битстримы, а разводка занимает 60 процентов времени. Буфер — один слой этой картины, а окно спеки снова открывает cts.t27, где строятся bufg() и тестируется bufg_has_higher_fanout().

Попробуйте

В виджете найдите два времени сборки и долю разводки в процентах; затем в окне спеки найдите bufg() и тест, дающий ей больший фан-аут.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri game-selftest: the queen loop checks its own tools
tri game-selftest: the queen loop checks its own tools ↗

6 of 6 self-tests hold: anomalies, blog_drift, lessons, site_gate, tick, vault.

specs/fpga/cts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -292,6 +324,7 @@ 

Глобальный буфер

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/golden-model/index.html b/apps/website/public/ru/learn/golden-model/index.html index 14efc6fbe1..19d1dacce8 100644 --- a/apps/website/public/ru/learn/golden-model/index.html +++ b/apps/website/public/ru/learn/golden-model/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Золотая модель

Вы научитесь

Что такое эталонная модель и как набор соответствия держит инструмент в рамках.

Чтобы судить об реализации, нужен ответ, который из неё не пришёл: золотая модель. Для числового формата это таблица из статьи; для инструмента — эталон, на соответствие которому он заявлен. Виджет — это прогон соответствия для собственного FPGA-инструментария t27: 17 из 17 spec соответствия компилируются, их тест-блоки проходят, и ни один сгенерированный файл не разошёлся с зафиксированным. Spec урока — каркас, общий для всех этих тестбенчей: формы, которые тестбенч обязан иметь, прежде чем сможет что-то проверять.

Попробуйте

Откройте tri-fpga-specs и прочитайте тест-блоки одного spec соответствия; затем откройте testbench.t27 и назовите четыре формы, которые обязан иметь тестбенч.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-specs: every board spec, compiled and tested
tri fpga-specs: every board spec, compiled and tested ↗

17 of 17 conformance specs compile, their test blocks pass, and no generated file has drifted.

specs/fpga/testbench.t27

// SPDX-License-Identifier: Apache-2.0
@@ -358,6 +390,7 @@ 

Золотая модель

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/golden-ruler-vectors/index.html b/apps/website/public/ru/learn/golden-ruler-vectors/index.html index cb7ba1e012..a72c1e08f0 100644 --- a/apps/website/public/ru/learn/golden-ruler-vectors/index.html +++ b/apps/website/public/ru/learn/golden-ruler-vectors/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Векторы как эталонная линейка

Вы научитесь

Как каталог работает линейкой: каждая популяция пересчитана, каждый счёт сходится.

Линейка работает, только если не растягивается. Каталог форматов — линейка t27 для числовых форматов, а виджет — проверка самой линейки: четыре переписные популяции, посчитанные в каталоге и пересчитанные другим способом, сходятся все, а три, которые проверить нельзя, названы непроверяемыми, а не подогнаны под согласие. Вот образец, который стоит копировать: пересчитывайте каждый счёт вторым способом и публикуйте те, что не пересчитались.

Попробуйте

Откройте виджет переписи и назовите три популяции, помеченные непроверяемыми; затем найдите в каталоге форматов счёт, названный дважды.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri census audit: every census, counted twice
tri census audit: every census, counted twice ↗

Four census populations recounted another way all agree; three are named as uncheckable.

specs/numeric/formats_catalog.t27

// SPDX-License-Identifier: Apache-2.0
@@ -563,6 +595,7 @@ 

Векторы как эталонная линейка

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/goldenfloat/all/card.png b/apps/website/public/ru/learn/goldenfloat/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..f8e8671de71638c33260694add30508e50924917 GIT binary patch literal 44891 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�U3AC`ts$E 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

ledn@5H58jU)oY2PJZMv`|gttJRrZS|KVxjbqaJ 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 XEc^7@7Z%9juY&>9^lGJ!OZdM5AJSke literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/goldenfloat/all/index.html b/apps/website/public/ru/learn/goldenfloat/all/index.html new file mode 100644 index 0000000000..e6e4cb0137 --- /dev/null +++ b/apps/website/public/ru/learn/goldenfloat/all/index.html @@ -0,0 +1,482 @@ + + + + + + +GoldenFloat на t27: одно правило, семнадцать ширин чисел: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

GoldenFloat на t27: одно правило, семнадцать ширин чисел

+

Он идёт после курса «ИИ-числа». Каждый урок открывает таблицу из одной спеки рядом с этой спекой, запущенной в браузере; где комментарий спеки расходится с её кодом, урок говорит, что есть что.

+

Курс 3, 9 модулей по 3 урока, в каждом виджет и спека t27: семейство GoldenFloat, где одно правило на основе phi делит каждую ширину от 4 до 1024 битов на знак, порядок и мантиссу, а затем то же деление с порядком в тритах.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

Пройдено 0 из 27

+

Открыть интерактивный курс →

+
+

Модуль 1 · Правило и его числа

Одно правило делит каждую ширину, отношение, к которому оно стремится, и числа Люка за тройкой 3.

+
+
01

Урок 1 из 27

Число с плавающей точкой, разрезанное по phi

+
+

Вы узнаетеКак одно правило, E = round((N - 1) / phi^2), делит каждую ширину GoldenFloat на знак, порядок и мантиссу.

Число с плавающей точкой тратит биты на три поля: один бит знака, порядок для диапазона и мантиссу для точности. IEEE 754 выбирает это деление комитетом для каждой ширины. GoldenFloat использует одно правило для всех: из N - 1 битов после знака round((N - 1) / phi^2) уходят в порядок, остальные в мантиссу, так что отношение E / M держится около 1 / phi, примерно 0.618. Спека семейства перечисляет 17 ширин от GF4 до GF1024, и GF16 она отмечает основным.

Попробуйте

Запустите тесты goldenfloat_family.t27 и найдите тот, что считает семейство. Затем найдите, какой формат спека отмечает основным, и тест, который говорит, что он один.

+
GoldenFloat 1: one rule for every widthВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/goldenfloat_family.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Phi как отношение

+
+

Вы узнаетеКак phi_ratio.t27 считает деление для любой ширины и почему расстояние до 1 / phi уменьшается не на каждом шаге.

phi_ratio.t27 задаёт PHI_RATIO_TARGET равным 1 / phi, около 0.618, а его функция phi_split работает для любой ширины: из N - 1 битов после знака round((N - 1) / phi^2) идут в порядок, остальные в мантиссу. Его таблица verify_phi_split держит семь ширин, и все семь совпадают с семейством: GF4 делится на 1 и 2, GF8 на 3 и 4, GF12 на 4 и 7, GF16 на 6 и 9, GF20 на 7 и 12, GF24 на 9 и 14, GF32 на 12 и 19. Расстояние до 1 / phi падает не на каждом шаге: GF8 с 0.132 дальше, чем GF4 с 0.118, а GF16 с 0.049 дальше, чем GF12 с 0.047.

Попробуйте

Запустите тесты phi_ratio.t27 и найдите тот, что проверяет GF16 на 6 и 9. Затем сравните 3 / 4 и 4 / 7 с 0.618 и скажите, что дальше.

+
GoldenFloat 2: phi as a ratioВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/phi_ratio.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Числа Люка остаются целыми

+
+

Вы узнаетеПочему phi^(2n) + phi^(-2n) всегда целое число и откуда берётся 3 в phi^2 + 1/phi^2 = 3.

phi иррационально, но phi^2 + phi^(-2) равно ровно 3. Это не случайность: phi^k + (-1/phi)^k — число Люка L_k, а числа Люка целые: 2, 1, 3, 4, 7, 11, 18 и дальше, каждое — сумма двух предыдущих. Спека считает phi^(2n) + phi^(-2n) в f64 и сверяет с L_2n для n от 0 до 6 с допуском 1e-9. Число 3 из девиза проекта — это L_2.

Попробуйте

Запустите тесты и прочитайте лестницу от n = 0 до n = 6. Затем найдите инвариант, который называет TRINITY числом L_2, и допуск, который позволяет сравнение в f64.

+
GoldenFloat 3: Lucas numbers stay wholeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/lucas_accumulator.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Почему phi, почему три

Почему деление идёт по phi, почему основание три и как спека проверяет, что GF16 хранит phi.

+
+
04

Урок 4 из 27

Почему деление по phi

+
+

Вы узнаетеДва довода за деление по phi и почему спека говорит, что довод о самоподобии — не оптимизация.

phi_split_optimality.t27 приводит два довода и говорит, какой из них какой. Один довод — самоподобие: потребуем, чтобы порядок относился к мантиссе, как мантисса к обоим полям вместе, E / M = M / (E + M). С r = E / M это r = 1 / (r + 1), значит r^2 + r - 1 = 0 и r = (sqrt(5) - 1) / 2 = 1 / phi. Спека прямо говорит, что это определяющее свойство, а не оптимизация: если просто максимизировать E * M, деление выходит поровну, 7 и 7 для 14 битов. Другой довод — про округление: round((N - 1) / phi^2) — ближайшее к идеалу целое, и verify_7_7_match находит его равным опубликованному делению в 7 из 7 форматов.

Попробуйте

Прочитайте self_similarity_proof_steps и сосчитайте шаги. Затем найдите тест, который говорит, что деление по AM-GM отличается от деления по phi, и ширину, которую он берёт.

+
GoldenFloat 4: why the split is phiВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/math/phi_split_optimality.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Почему основание три

+
+

Вы узнаетеПочему ln(b) / b достигает пика в e, насколько близко подходит основание 3 и сколько битов стоят 27 тритов.

Экономия основания оценивает основание b числом E(b) = ln(b) / b, и анализ ставит пик в b = e, где E = 1 / e = 0.36788. radix_economy.t27 вписывает соседей: E(2) = 0.34657 и E(3) = 0.36620. Основание 3 достигает 0.995 от пика, а E(3) / E(2) = 1.0566, преимущество 5.66 процента; спека ограничивает его снизу числом 0.054, то есть 5.4 процента, хотя инвариант назван 54_percent. По диапазону 27 сбалансированных тритов доходят до 3812798742493, выше 2^41 - 1 и ниже 2^42 - 1, так что им нужно 42 бита. Это доводы о цифрах, а не замер времени на троичной машине.

Попробуйте

Разделите E_BASE3 на E_BASE2 из radix_economy.t27 вручную. Затем найдите инвариант с именем 54_percent и скажите, какое число он на самом деле проверяет.

+
GoldenFloat 5: why base threeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/math/radix_economy.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Phi в шестнадцати битах

+
+

Вы узнаетеКак спека проверяет, что GF16 сохраняет phi, phi^2 = phi + 1 и phi^2 + 1/phi^2 = 3 с заявленным допуском.

Формат хорош настолько, насколько он сохраняет тождества. В gf_competitive.t27 пять проверок: phi, записанное в GF16, против его точного значения, phi^2 против phi + 1, сумма phi^2 + 1/phi^2 против 3, туда-обратно и сумма 1000 слагаемых. Читайте их как есть: значения в каждом тесте вписаны в сам тест, а не получены кодировщиком этой спеки. Спека проверяет арифметику ошибки с допусками 1e-4 и 5e-3.

Попробуйте

Запустите тесты и найдите значение, которое каждый тест вписывает для phi^2 и для phi + 1. Затем найдите, какие два теста используют более строгий допуск 1e-4.

+
GoldenFloat 6: phi in sixteen bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf_competitive.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Малые ступени: от GF4 до GF8

GF4, GF6 и GF8 — меньше всего битов, и округление до целых битов стоит здесь дороже всего.

+
+
07

Урок 7 из 27

GF4: четыре бита

+
+

Вы узнаетеСамый маленький GoldenFloat: один бит знака, один бит порядка, два бита мантиссы, смещение 0.

В GF4 4 бита: 1 знак, 1 порядок, 2 мантиссы, и смещение порядка равно 0. С одним битом порядка есть только два масштаба, 1 и 2, поэтому его 16 кодов грубые. Правило даёт E = round(3 / phi^2) = 1, а отношение E / M равно 0.5, на 0.118 от 1 / phi. Курс «ИИ-числа» открывает ту же спеку по другой причине; здесь это нижняя ступень семейства.

Попробуйте

Найдите EXP_BIAS и PHI_DISTANCE в gf4.t27, затем инвариант, который ограничивает расстояние. Откройте функцию decode и найдите два масштаба, которые даёт один бит порядка.

+
GoldenFloat 7: GF4, four bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf4.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

GF6: шесть битов

+
+

Вы узнаетеКак правило делит 6 битов на 1 + 2 + 3 и что значит смещение 1.

В GF6 6 битов: 1 знак, 2 порядка, 3 мантиссы. Два бита порядка дают коды от 0 до 3, и со смещением 1 масштаб идёт от 2^-1 до 2^2. Отношение E / M равно 0.667, на 0.049 от 1 / phi. В спеке есть и строка статуса: смещение не выводится из замкнутой формулы, оно выбирается для каждого формата, и спека так и пишет.

Попробуйте

Найдите BIAS и EXP_MAX в gf6.t27 и сверьте их с 2^(E-1) - 1 и 2^E - 1. Затем прочитайте PHI_BIAS_STATUS и скажите, что он признаёт.

+
GoldenFloat 8: GF6, six bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf6.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

GF8: один байт

+
+

Вы узнаетеGoldenFloat в один байт, 1 + 3 + 4, смещение 3, и каковы его наибольшее и наименьшее значения.

gf8.t27 держит один байт: 1 бит знака, 3 бита порядка, 4 бита мантиссы и смещение 3, то есть 2^(3 - 1) - 1. PHI_DISTANCE равно 0.132 — это дальше всех из семи ширин, что перечисляет phi_ratio.t27, ведь 3 / 4 = 0.75 перелетает 1 / phi. Наибольшее значение, по max_value, равно (1 + 15/16) * 2^(7 - 3) = 31, а наименьшее, по min_positive, 1/16 * 2^-2 = 1/64. Комментарии над обеими функциями говорят 15.5 и 0.0625; код считает 31 и 1/64. MEMORY_RATIO_VS_FP32 равно 0.25: четыре значения GF8 помещаются там, где одно FP32.

Попробуйте

Посчитайте max_value и min_positive из gf8.t27 вручную и сравните с комментариями над ними. Затем декодируйте код 0b01000000, который тест gf8_phi_distance ждёт для phi, и скажите, какое значение в нём.

+
GoldenFloat 9: GF8, one byteВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf8.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · От десяти до четырнадцати битов

GF10, GF12 и GF14 и то, как расстояние до 1 / phi меняется с ростом слова.

+
+
10

Урок 10 из 27

GF10: десять битов

+
+

Вы узнаетеКак 10 битов делятся на 1 + 3 + 6 и почему его отношение стоит в 0.118 от 1 / phi.

В GF10 10 битов: 1 знак, 3 порядка, 6 мантиссы, смещение 3. Правило даёт E = round(9 / phi^2) = 3, а E / M равно 0.5, на том же расстоянии 0.118 от 1 / phi, что и у GF4. Платой служит округление до целых битов: на малых ширинах выбирать почти не из чего.

Попробуйте

Найдите EM_RATIO и PHI_DIST в gf10.t27. Затем посчитайте round(9 / phi^2) сами и сверьте с EXP_BITS.

+
GoldenFloat 10: GF10, ten bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf10.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

GF12: двенадцать битов

+
+

Вы узнаетеGoldenFloat в двенадцать битов, 1 + 4 + 7, смещение 7, и как имя теста может обещать больше, чем его проверка.

gf12.t27 держит 12 битов: 1 бит знака, 4 бита порядка, 7 битов мантиссы и смещение 7. Его отношение E / M равно 4 / 7 = 0.571, а PHI_DISTANCE равно 0.0466. Тест, который это проверяет, называется gf12_phi_distance_lowest, но утверждает лишь, что расстояние меньше 0.05, а комментарий в спеке называет GF12 ближайшим из всех форматов. Семейство говорит иначе: GF14 в следующем уроке стоит в 0.007 от 1 / phi, а GF32 в 0.0135. Читайте тест по его assert, а не по имени. MEMORY_RATIO_VS_FP32 равно 12 / 32 = 0.375.

Попробуйте

Найдите PHI_DISTANCE и тест gf12_phi_distance_lowest в gf12.t27. Затем сравните расстояние с GF14 и GF32 и скажите, что обещает имя теста, чего не проверяет его assert.

+
GoldenFloat 11: GF12, twelve bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf12.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

GF14: четырнадцать битов

+
+

Вы узнаетеКак 14 битов делятся на 1 + 5 + 8, отношение в 0.007 от 1 / phi.

В GF14 14 битов: 1 знак, 5 порядка, 8 мантиссы, смещение 15. Его отношение E / M равно 0.625, всего в 0.007 от 1 / phi, потому что 5 и 8 — соседние числа Фибоначчи, а отношение соседей приближается к 1 / phi.

Попробуйте

Найдите PHI_DIST в gf14.t27 и сравните с GF10. Затем назовите следующую пару чисел Фибоначчи после 5 и 8.

+
GoldenFloat 12: GF14, fourteen bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf14.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · GF16 в работе

Основной 16-битный формат, скалярное произведение из двух слагаемых в GF-T16, затем GF20 и GF24.

+
+
13

Урок 13 из 27

GF16: основной формат

+
+

Вы узнаетеGoldenFloat на 16 битов, который семейство отмечает основным: 1 + 6 + 9, смещение 31 и его особые коды.

В GF16 16 битов: 1 знак, 6 порядка, 9 мантиссы, смещение 31. Код порядка 63, все единицы, оставлен для бесконечности и NaN, как в IEEE 754. Спека даёт имя каждому особому коду: 0x0000 и 0x8000 для двух нулей, 0x7E00 и 0xFE00 для двух бесконечностей, 0xFE01 для NaN. Мантисса из 9 битов делится на 512.

Попробуйте

Найдите SIGN_MASK, EXP_MASK и MANT_MASK в gf16.t27 и проверьте, что вместе они покрывают все 16 битов. Затем найдите код NaN и скажите, какое поле отличает его от бесконечности.

+
GoldenFloat 13: GF16, the primary formatВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf16.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Два произведения, одна сумма

+
+

Вы узнаетеКак умножение с накоплением в GF-T16 считает a1 * b1 + a2 * b2, ядро умножения матриц.

Каждый слой сети — стопка скалярных произведений, а скалярное произведение — сложенные произведения. gft_dot2.t27 — самое маленькое: y = a1 * b1 + a2 * b2 в GF-T16, 16-битной величине из 7-битного смещения и 9-битной мантиссы со смещением 40. В такой раскладке 1.0 — это код 20480, а 2.0 — код 20992. В спеке два теста: 1 * 1 = 1 и 1 * 1 + 1 * 1 = 2.

Попробуйте

Найдите оба теста и раскодируйте 20480 и 20992 вручную по value = (1 + mant / 512) * 2^(offset - 40). Затем найдите строку в gft_mul, которая обрабатывает перенос, когда произведение переходит 2.

+
GoldenFloat 14: two products, one sumВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/gft_dot2.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

GF20 и GF24

+
+

Вы узнаетеGoldenFloat в 20 и 24 бита, 1 + 7 + 12 и 1 + 9 + 14, и допуск, который даёт каждая спека.

gf20.t27 держит 1 бит знака, 7 битов порядка и 12 битов мантиссы со смещением 63; gf24.t27 держит 1 бит знака, 9 битов порядка и 14 битов мантиссы со смещением 255. Урок открывает gf24.t27: его PHI_DISTANCE равно 0.0248, а тест пропускает всё меньше 0.03; MEMORY_RATIO_VS_FP32 равно 0.75. GF20 записывает своё расстояние как 0.03463 при границе теста 0.04, тогда как 7 / 12 стоит в 0.03470 от 1 / phi: записанная константа и арифметика расходятся в четвёртом знаке. Обе ширины держат отношение в пределах 0.035 от 1 / phi.

Попробуйте

Найдите PHI_DISTANCE и EXP_BIAS в gf24.t27 и проверьте смещение по 2^(9 - 1) - 1. Затем посчитайте 7 / 12 против 0.618034 и сравните с константой, которую хранит gf20.t27.

+
GoldenFloat 15: GF20 and GF24Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf24.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · От GF32 до GF64

GF32 рядом с IEEE single, GF48 без пары в IEEE, GF64 рядом с IEEE double.

+
+
16

Урок 16 из 27

GF32: одинарная точность

+
+

Вы узнаетеGoldenFloat в 32 бита, 1 + 12 + 19, смещение 2047, и два инварианта, которые сравнивают его с IEEE single.

gf32.t27 держит 32 бита: 1 бит знака, 12 битов порядка, 19 битов мантиссы и смещение 2047. IEEE single тратит 8 битов на порядок и 23 на мантиссу; спека держит два инварианта, которые это говорят, EXP_BITS > 8 и MANT_BITS < 23, так что GF32 при той же ширине меняет точность на диапазон. Его PHI_DISTANCE равно 0.0135, ниже границы теста 0.015, а MEMORY_RATIO_VS_FP32 равно 1. Комментарий называет GF32 вторым после GF12; по расстояниям этого курса он ближе, чем GF12, а GF14 ещё ближе.

Попробуйте

Найдите два инварианта gf32.t27, которые сравнивают его с IEEE single. Затем проверьте EXP_BIAS по 2^(12 - 1) - 1 и посчитайте 12 / 19.

+
GoldenFloat 16: GF32, a singleВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf32.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

GF48: сорок восемь битов

+
+

Вы узнаетеКак правило делит 48 битов на 1 + 18 + 29, ширину, которой нет в IEEE 754.

В GF48 48 битов: 1 знак, 18 порядка, 29 мантиссы, смещение 131071. В IEEE 754 нет 48-битного формата; правило строит его так же, как все остальные. Его отношение E / M равно 0.621, в 0.003 от 1 / phi.

Попробуйте

Найдите BIAS и EXP_MAX в gf48.t27 и сверьте с 2^17 - 1 и 2^18 - 1. Затем найдите три константы сдвига и скажите, какое поле ставит каждая.

+
GoldenFloat 17: GF48, forty-eight bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf48.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

GF64: двойная точность

+
+

Вы узнаете64-битный GoldenFloat, 1 + 24 + 39, рядом с двойной точностью IEEE, и как его кодировщик ограничивает порядок.

В GF64 64 бита: 1 знак, 24 порядка, 39 мантиссы, смещение 8388607. Двойная точность IEEE тратит 11 битов на порядок и 52 на мантиссу; GF64 меняет мантиссу на гораздо более широкий диапазон. В его спеке есть кодировщик и декодер: мантисса делится на 2^39, а порядок ограничен между 0 и 2^24 - 1.

Попробуйте

Найдите EXP_BIAS, EXP_MAX и MANT_DIV в gf64.t27. Затем откройте encode и найдите, где ограничивается порядок.

+
GoldenFloat 18: GF64, a doubleВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf64.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · От GF96 до GF256

GF96, GF128 и GF256, где спеки держат раскладку инвариантами.

+
+
19

Урок 19 из 27

GF96: девяносто шесть битов

+
+

Вы узнаетеПочему спека 96-битного числа записывает смещение выражением, а не числом.

В GF96 96 битов: 1 знак, 36 порядка, 59 мантиссы. Его смещение, 2^35 - 1, уже не помещается в 64-битные целые, которыми спека пользуется для малых форматов, поэтому спека пишет его текстом 2^(36-1) - 1 и проверяет раскладку инвариантами. Отношение E / M равно 0.610.

Попробуйте

Найдите BIAS_EXPR и EXP_MAX_EXPR в gf96.t27 и сравните с BIAS в gf48.t27. Затем прочитайте инварианты и скажите, что проверяет каждый.

+
GoldenFloat 19: GF96, ninety-six bitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf96.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

GF128: четверная точность

+
+

Вы узнаете128-битный GoldenFloat, 1 + 49 + 78, и четыре инварианта, которые держат его раскладку.

В GF128 128 битов: 1 знак, 49 порядка, 78 мантиссы. Четверная точность IEEE тратит на порядок 15 битов. Спека держит раскладку четырьмя инвариантами: поля делят слово целиком, мантисса и порядок следуют замкнутой формуле, сдвиги следуют раскладке.

Попробуйте

Прочитайте четыре инварианта gf128.t27 и проверьте SIGN_SHIFT и EXP_SHIFT по ширинам полей вручную.

+
GoldenFloat 20: GF128, a quadВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf128.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

GF256: двести пятьдесят шесть битов

+
+

Вы узнаетеКак правило делит 256 битов на 1 + 97 + 158.

В GF256 256 битов: 1 знак, 97 порядка, 158 мантиссы. В спеке семейства есть тест и на эти числа. На такой ширине округление почти ничего не стоит, и отношение E / M равно 0.614, в 0.004 от 1 / phi.

Попробуйте

Найдите EM_RATIO и PHI_DIST в gf256.t27. Затем в goldenfloat_family.t27 найдите тест, который проверяет числа битов GF256, и проверьте, что обе спеки согласны.

+
GoldenFloat 21: GF256Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf256.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Самые широкие ступени, затем триты

GF512 и GF1024, две самые широкие ступени, затем GF-T8, где порядок уходит в триты.

+
+
22

Урок 22 из 27

GF512: пятьсот двенадцать битов

+
+

Вы узнаетеКак правило делит 512 битов на 1 + 195 + 316, отношение в пределах 0.001 от 1 / phi.

В GF512 512 битов: 1 знак, 195 порядка, 316 мантиссы. Его отношение E / M равно 0.617, меньше чем в 0.001 от 1 / phi. Чем шире слово, тем ближе целые биты могут подойти к цели, и таблица семейства это показывает.

Попробуйте

Найдите PHI_DIST в gf512.t27 и сравните с GF14 и GF48. Затем проверьте SIGN_SHIFT и EXP_SHIFT вручную.

+
GoldenFloat 22: GF512Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf512.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

GF1024: один килобит

+
+

Вы узнаетеСамая широкая ступень семейства, 1 + 391 + 632, и тест, который её называет.

В GF1024 1024 бита: 1 знак, 391 порядка, 632 мантиссы. Его отношение E / M равно 0.6187, на расстоянии 0.0006 от 1 / phi, и в спеке семейства есть тест, который называет GF1024 форматом с наименьшим расстоянием до phi. Это ступень семейства на бумаге; никакое железо в этом курсе на нём не считает.

Попробуйте

Найдите PHI_DIST в gf1024.t27. Затем в goldenfloat_family.t27 найдите тест про GF1024 и функцию, которую он вызывает.

+
GoldenFloat 23: GF1024, one kilobitВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gf1024.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

GF-T8: порядок в тритах

+
+

Вы узнаетеКак GF-T сохраняет деление по phi, но хранит порядок в сбалансированных тритах: 1 + 3 трита + 4 бита.

GF-T — это GoldenFloat с троичным порядком. В GF-T8 1 знак, 3 трита порядка и 4 бита мантиссы. Три трита дают 27 значений порядка, смещение 13 делает их сбалансированными вокруг нуля, а смещение 26 оставлено как особое неконечное значение. Спека проверяет деление как E / M в тысячных: 3000 / 4 = 750.

Попробуйте

Запустите два теста gft8.t27. Затем найдите exp_values и is_finite и скажите, какое смещение не конечно.

+
GoldenFloat 24: GF-T8, an exponent in tritsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gft8.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · Ещё триты, затем декодирование

GF-T16 и GF-T32, затем почему фиксированные поля декодируются параллельно, а posit — нет.

+
+
25

Урок 25 из 27

GF-T16: шесть тритов

+
+

Вы узнаетеКак GF-T16 тратит 6 тритов порядка и 9 битов мантиссы и сколько значений порядка это даёт.

В GF-T16 1 знак, 6 тритов порядка и 9 битов мантиссы. Шесть тритов дают 3^6 = 729 значений порядка; смещение 364 балансирует их, а смещение 728 не конечно. Деление в тысячных: 6000 / 9 = 666. Мантисса у него те же 9 битов, что у GF16, так что они различаются только тем, как хранят порядок.

Попробуйте

Запустите два теста gft16.t27. Затем сравните MANT_BITS с GF16 и посчитайте, какой диапазон вокруг нуля покрывают 729 значений порядка.

+
GoldenFloat 25: GF-T16, six tritsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gft16.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

GF-T32: двенадцать тритов

+
+

Вы узнаетеКак GF-T32 тратит 12 тритов порядка и 19 битов мантиссы.

В GF-T32 1 знак, 12 тритов порядка и 19 битов мантиссы. Двенадцать тритов дают 3^12 = 531441 значение порядка; смещение 265720 балансирует их, а смещение 531440 не конечно. Деление в тысячных: 12000 / 19 = 631. 19 битов мантиссы совпадают с GF32 в таблице семейства.

Попробуйте

Запустите два теста gft32.t27 и проверьте 3^12 вручную. Затем сравните его мантиссу со строкой GF32 в спеке семейства.

+
GoldenFloat 26: GF-T32, twelve tritsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/numeric/gft32.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Раскодировать за один шаг

+
+

Вы узнаетеПочему формат с полями фиксированной длины раскодирует поля параллельно, а позит не может, как спека считает шаги.

Позит кладёт перед порядком режим переменной длины, поэтому декодер должен найти конец режима, прежде чем сможет прочитать что-то ещё. GF16 и IEEE FP16 держат каждое поле на фиксированном месте, поэтому все поля раскодируются сразу. gf_competitive.t27 считает шаги: 3 у FP16, 6 у POSIT16, 3 у GF16, и отмечает, какие можно выполнять параллельно. Это числа, вписанные в спеку, а не время, измеренное на железе.

Попробуйте

Найдите decode_complexity и три записи, которые она возвращает. Затем найдите инвариант, который сравнивает позит с GF16, и скажите, что добавило бы измерение времени на железе.

+
GoldenFloat 27: decode in one stepВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/math/gf_competitive.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Правило и его числа
    1. 01 Число с плавающей точкой, разрезанное по phi
    2. 02 Phi как отношение
    3. 03 Числа Люка остаются целыми
  2. 02 · Почему phi, почему три
    1. 04 Почему деление по phi
    2. 05 Почему основание три
    3. 06 Phi в шестнадцати битах
  3. 03 · Малые ступени: от GF4 до GF8
    1. 07 GF4: четыре бита
    2. 08 GF6: шесть битов
    3. 09 GF8: один байт
  4. 04 · От десяти до четырнадцати битов
    1. 10 GF10: десять битов
    2. 11 GF12: двенадцать битов
    3. 12 GF14: четырнадцать битов
  5. 05 · GF16 в работе
    1. 13 GF16: основной формат
    2. 14 Два произведения, одна сумма
    3. 15 GF20 и GF24
  6. 06 · От GF32 до GF64
    1. 16 GF32: одинарная точность
    2. 17 GF48: сорок восемь битов
    3. 18 GF64: двойная точность
  7. 07 · От GF96 до GF256
    1. 19 GF96: девяносто шесть битов
    2. 20 GF128: четверная точность
    3. 21 GF256: двести пятьдесят шесть битов
  8. 08 · Самые широкие ступени, затем триты
    1. 22 GF512: пятьсот двенадцать битов
    2. 23 GF1024: один килобит
    3. 24 GF-T8: порядок в тритах
  9. 09 · Ещё триты, затем декодирование
    1. 25 GF-T16: шесть тритов
    2. 26 GF-T32: двенадцать тритов
    3. 27 Раскодировать за один шаг
+ + + + + diff --git a/apps/website/public/ru/learn/goldenfloat/index.html b/apps/website/public/ru/learn/goldenfloat/index.html index 4e093da75e..0a4368ddba 100644 --- a/apps/website/public/ru/learn/goldenfloat/index.html +++ b/apps/website/public/ru/learn/goldenfloat/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

GoldenFloat на t27: одно правило, семнадцать ширин чисел

Он идёт после курса «ИИ-числа». Каждый урок открывает таблицу из одной спеки рядом с этой спекой, запущенной в браузере; где комментарий спеки расходится с её кодом, урок говорит, что есть что.

Курс 3, 9 модулей по 3 урока, в каждом виджет и спека t27: семейство GoldenFloat, где одно правило на основе phi делит каждую ширину от 4 до 1024 битов на знак, порядок и мантиссу, а затем то же деление с порядком в тритах.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/gradient-descent/index.html b/apps/website/public/ru/learn/gradient-descent/index.html index cd1c2f6cc3..fdc53b9904 100644 --- a/apps/website/public/ru/learn/gradient-descent/index.html +++ b/apps/website/public/ru/learn/gradient-descent/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Градиентный спуск

Вы узнаете

Как градиентный спуск идёт вниз по функции потерь, что добавляет момент и почему слишком большой шаг никогда не успокаивается.

Обучение это спуск под гору по функции потерь. Градиентный спуск каждый шаг сдвигает вес на -lr, умноженное на его градиент; в спеке потеря равна (x - 3)^2 от x = 0, и lr 0.1 доходит до 2.99996 за 50 шагов. Момент добавляет долю прошлого сдвига, что ускоряет длинный склон и перелетает острое дно: при 0.9 вес пролетает 3 примерно до 5.13 и, раскачиваясь, приходит к 3.09 после 50 шагов. Нестеров берёт градиент на шаг вперёд и качается меньше, примерно до 4.25. Слишком большой шаг никогда не успокаивается: при lr 1 вес навсегда скачет между 0 и 6. Спека sgd.t27 вычисляет каждый шаг.

Попробовать

Найдите наибольший шаг обучения, который ещё успокаивается без момента; затем добавьте момент 0.9 и сосчитайте качания.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Gradient descent: how a network walks downhill
Gradient descent: how a network walks downhill ↗

Set the learning rate and momentum and watch a weight walk from 0 to the bottom of (x - 3)^2. Plain steps creep, momentum overshoots and rings, and a rate of 1 bounces forever.

specs/ml/optimizer/sgd.t27

// SPDX-License-Identifier: Apache-2.0
@@ -232,6 +264,7 @@ 

Градиентный спуск

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/gray-code/index.html b/apps/website/public/ru/learn/gray-code/index.html index fad4365c54..0a0a7b0379 100644 --- a/apps/website/public/ru/learn/gray-code/index.html +++ b/apps/website/public/ru/learn/gray-code/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Код Грея

Вы узнаете

Почему код Грея меняет по одному биту за шаг и чего не может увидеть набор тестов, не читающий указатели.

Код Грея меняет ровно один бит за шаг, поэтому сэмпл, взятый посреди изменения, даёт один из двух соседних кодов — ошибку на единицу, но не мусор. FIFO, чьи указатели чтения и записи считают по Грею, можно безопасно сэмплировать через домены, и выводимые из них флаги держатся. Запись подкладывает мутацию, которую Грей поймал бы с поличным, если бы тесты смотрели: (state.head_ptr + 1) превращается в + 3, и все тесты по-прежнему проходят, потому что набор утверждает заполнение и флаги, но никогда значения указателей. Набор тестов защищает то, что он читает; кодировку защищает правило следующего урока, а не эти тесты. Запись восстанавливает спеку и печатает её sha256.

Попробуйте

В записи найдите строку sed и убедитесь, что ни один тест не упал; затем в окне спеки найдите утверждения о заполнении и флагах и укажите дыру, в которую проскользнула мутация.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on fifo.t27 -- a pointer mutation the tests cannot see
t27c on fifo.t27 -- a pointer mutation the tests cannot see ↗

head_ptr + 1 to + 3 in one sed: every test still passes, because the suite asserts fill counts and flags, never pointer values -- the exact hole a torn multi-bit pointer would slip through; git restores the spec.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Код Грея

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/growth-through-the-stages/index.html b/apps/website/public/ru/learn/growth-through-the-stages/index.html index 217eb58bbb..eebb152a2b 100644 --- a/apps/website/public/ru/learn/growth-through-the-stages/index.html +++ b/apps/website/public/ru/learn/growth-through-the-stages/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Рост через этапы

Вы узнаете

На сколько бит растут слова БПФ и что удерживает и чего лишает деление пополам на каждом этапе.

Каждый этап по основанию 2 может удвоить значение, поэтому БПФ без масштабирования вырастает до log2 N бит, а консервативная ширина ядра БПФ от AMD равна B + log2 N + 1. Вход DC полной шкалы показывает это наглядно: 12 бит на входе, 16 бит на выходе 16-точечного БПФ против 17 по правилу. Деление пополам на каждом этапе удерживает слово на 12 битах, но размазанный сигнал теряет бит точности на каждом этапе. Спека signals.t27 исполняет целочисленное БПФ, которое измеряет виджет.

Попробовать

Прогоните DC без масштабирования и с делением; затем прогоните шумовой вход обоими способами и сравните наибольший выход.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

FFT word growth: how many bits each stage adds
FFT word growth: how many bits each stage adds ↗

Pick a size, an input width and an input, with or without halving every stage. Watch the bits each stage needs grow, and what scaling holds back and what it costs.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Рост через этапы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/half-adder/index.html b/apps/website/public/ru/learn/half-adder/index.html index 30f71bdf26..df951f3437 100644 --- a/apps/website/public/ru/learn/half-adder/index.html +++ b/apps/website/public/ru/learn/half-adder/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Полусумматор

Вы узнаете

Два трита на входе, трит суммы и трит переноса на выходе, все девять случаев.

Полусумматор — это таблицы суммы и переноса, поставленные рядом. Спека вычисляет обе из trit_at() от a + b: разряд 0 — сумма, разряд 1 — перенос. Из девяти пар входов перенос дают только +1 + +1 и -1 + -1; всё остальное умещается в один трит. Двоичный полусумматор переносит в одном случае из четырёх, троичный — в двух из девяти.

Попробовать

Пройдите все девять случаев в полосе и посчитайте, сколько из них дают перенос; сравните с четырьмя случаями двоичного полусумматора.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The half adder: two trits in, a sum and a carry out
The half adder: two trits in, a sum and a carry out ↗

Pick two trits. The half adder writes their sum as a sum trit plus three times a carry trit; all nine cases below.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Полусумматор

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/handshakes-and-pulses/index.html b/apps/website/public/ru/learn/handshakes-and-pulses/index.html index e924a46c08..ceef0b5803 100644 --- a/apps/website/public/ru/learn/handshakes-and-pulses/index.html +++ b/apps/website/public/ru/learn/handshakes-and-pulses/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Рукопожатия и импульсы

Вы узнаете

Как рукопожатие переносит импульс между мирами и что общего у отчёта по фронтам и тоггл-синхронизатора.

Импульс перенести труднее всего: один такт здесь — не один такт там. Рукопожатие превращает его в уровень: сторона отправителя поднимает запрос, приёмник его сэмплирует, поднимает подтверждение, и запрос падает — четыре фронта, и импульс стал разговором. Виджет — отчёт, работающий так же: 25 живых проверок, печатающий только строки NEW red или CLEARED с прошлого взгляда — дальняя сторона видит изменение, а не уровень, ровно то, что тоггл-синхронизатор устраивает в железе. Окно спеки открывает clock_domain.t27, чья стратегия handshake — этот разговор в виде одного значения перечисления.

Попробуйте

В виджете найдите, сколько проверок ведёт отчёт и что он печатает, когда ничего не изменилось; затем в окне спеки найдите стратегию handshake и посчитайте фронты её разговора.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri game-tick: one anomaly scan, only what changed
tri game-tick: one anomaly scan, only what changed ↗

25 live checks on t27.ai and its publisher; prints only NEW red or CLEARED rows. This run: 0 red of 25.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

Рукопожатия и импульсы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/hello-t27/index.html b/apps/website/public/ru/learn/hello-t27/index.html index 7124a4abe5..077610eb0c 100644 --- a/apps/website/public/ru/learn/hello-t27/index.html +++ b/apps/website/public/ru/learn/hello-t27/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Привет, t27

Вы узнаете

Как выглядит спека t27 и что с ней делает компилятор прямо в вашем браузере.

Программа на t27 — это спека: модуль с типизированными константами, функциями и тестами. Строки прозы начинаются с точки с запятой в начале строки. Плеер ниже запускает настоящий компилятор t27, собранный в WebAssembly, внутри вашего браузера: он читает hello_world.t27, прогоняет его тесты и пишет код для семи бэкендов. Ничего не устанавливается и ничего никуда не отправляется. Откройте учебную спеку под виджетом и читайте её рядом с выводом.

Попробуйте

Запустите тесты в плеере, затем переключите бэкенд и найдите одну и ту же функцию на двух языках.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

hello_world.t27, compiled inside the post
hello_world.t27, compiled inside the post ↗

The t27 compiler, as WebAssembly, running on one spec in your browser: lexer to seven backends, the spec's own tests, the emitted code, its Verilog read for synthesis, and a terminal.

specs/tutorial/02_functions.t27

// SPDX-License-Identifier: Apache-2.0
@@ -151,6 +183,7 @@ 

Привет, t27

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/how-much-fits/index.html b/apps/website/public/ru/learn/how-much-fits/index.html index f858911a79..91d274a3e9 100644 --- a/apps/website/public/ru/learn/how-much-fits/index.html +++ b/apps/website/public/ru/learn/how-much-fits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сколько помещается на чип

Вы узнаете

Как читать подсчёт ресурсов и находить, какой ресурс кончится раньше.

Отчёт синтеза говорит, сколько LUT, триггеров, DSP и блоков памяти занимает дизайн. Важный вопрос — какой из них кончится раньше. Дизайн может занимать мало LUT и всё равно не влезть, потому что ему нужно больше DSP, чем есть на чипе. Введите число LUT или выберите один из наших настоящих дизайнов и посмотрите, сколько копий влезет в XC7A200T.

Попробуйте

Выберите настоящий дизайн, затем увеличивайте число DSP, пока раньше LUT не кончится что-то другое. В спеке fits_board проверяет четыре ресурса по очереди: какой идёт последним и сколько блоков DSP48 перечисляет xc7a100t_resources?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Fits on a 200T: how many copies of your design an XC7A200T holds
Fits on a 200T: how many copies of your design an XC7A200T holds ↗

Type your LUT count (and FF, DSP, BRAM) and see how many copies fit on an XC7A200T, one grid cell per copy, and which resource runs out first. Totals from nextpnr-xilinx.

specs/fpga/stdlib.t27

// SPDX-License-Identifier: Apache-2.0
@@ -439,6 +471,7 @@ 

Сколько помещается на чип

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/if-and-else/index.html b/apps/website/public/ru/learn/if-and-else/index.html index ea579f6f4d..d653a8f255 100644 --- a/apps/website/public/ru/learn/if-and-else/index.html +++ b/apps/website/public/ru/learn/if-and-else/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Выбор: if, else и switch

Вы узнаете

Формы if, которые принимает компилятор, выражение if и switch с else.

if (a > b) { ... } else { ... } выполняет один из двух блоков. Скобки необязательны: if a > b { ... } тоже компилируется. if бывает и выражением: return if (a > b) a else b; даёт большее из двух. switch (m) { 0 => 10, else => 20 } выбирает значение по совпадению m, а else покрывает все остальные случаи.

Попробуйте

Добавьте в switch в плеере случай 1 => 15 и проверьте вердикт.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 14: the shapes of a choice
t27 basics 14: the shapes of a choice ↗

Every form of if and switch the t27 compiler accepts, each checked with the real compiler. Lesson 14 of the t27 basics course.

specs/basics/14_if_and_else.t27

// SPDX-License-Identifier: Apache-2.0
@@ -98,6 +130,7 @@ 

Выбор: if, else и switch

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/index.html b/apps/website/public/ru/learn/index.html index 41e31f78ab..e44b0dfe45 100644 --- a/apps/website/public/ru/learn/index.html +++ b/apps/website/public/ru/learn/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

Основы t27: язык за 27 уроков

Перед курсом по FPGA: что такое спека t27, как компилятор её читает и что отдаёт в ответ. Каждый урок открывает таблицу или схему из своей спеки и одну спеку, которую можно запустить в браузере.

Курс 0, 27 уроков, в каждом инфографика и спека t27: модуль, константы и типы, функции и тесты, затем стадии компилятора и 7 языков, которые он пишет. Идёт перед курсом по FPGA.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

  1. Основы t27: язык за 27 уроков
  2. С нуля до чипа: программирование FPGA на t27
  3. ИИ-числа на t27: от форматов чисел до тернарной сети
  4. GoldenFloat на t27: одно правило, семнадцать ширин чисел
  5. Проверка железа с t27: тестбенчи, временные диаграммы, формальные методы, мутации
  6. Тактирование, сброс и пересечения тактовых доменов на t27
  7. Шины и периферия на t27: UART, SPI, APB, AXI4, Ethernet
  8. Троичная машина: от трита до работающей программы
  9. Арифметика и DSP на FPGA: от цепи переноса до фильтра
  10. Нейросети на t27: от одного нейрона до блока трансформера
  11. Королева и улей: как проект t27 строит себя сам

Все уроки

+
diff --git a/apps/website/public/ru/learn/induction/index.html b/apps/website/public/ru/learn/induction/index.html index ed9c85aff3..9cbafd9020 100644 --- a/apps/website/public/ru/learn/induction/index.html +++ b/apps/website/public/ru/learn/induction/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Индукция

Вы научитесь

Почему ограниченность — не доказательство и как индукция закрывает разрыв — или честно сообщает, что не может.

Ограниченность значит ограниченность: k проверенных тактов — это всё, что k доказывает. Чтобы закрыть разрыв, нужна индукция — предположить, что инвариант держался до такта k, и показать, что он держится на такте k+1, — и индукция честна так, как ограниченный перебор не бывает: она может не получиться, и неуспех индукции — находка, а не конфуз. Виджет показывает, как выглядит непогашенное обязательство, на которое никто не смотрит: 12 файлов Lean, 15,553 строки и 4 sorry, до которых не добирается ни один корень сборки — ничто их не компилирует, значит доказательства в них никогда не проверялись. Обязательство, до которого не добирается ни один корень, не погашено — оно припарковано.

Попробуйте

Найдите 4 sorry в прогоне по Lean и скажите, что изменил бы корень сборки, который до них добирается; затем назовите инвариант uart_tb, который попробовали бы доказать индукцией.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri lean: proofs that nothing compiles
tri lean: proofs that nothing compiles ↗

12 Lean files, 15,553 lines and 4 sorry, are reached by no build root: nothing compiles them.

specs/fpga/testbench/formal_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -205,6 +237,7 @@ 

Индукция

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/inherited-red/index.html b/apps/website/public/ru/learn/inherited-red/index.html index 1dd4349b57..0271f90e50 100644 --- a/apps/website/public/ru/learn/inherited-red/index.html +++ b/apps/website/public/ru/learn/inherited-red/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Унаследованный красный

Вы узнаете

Когда красная проверка пулл-реквеста унаследована от master и почему отменённый запуск ничего не говорит.

Пчела может одобрить PR с красной проверкой, если эта проверка красная и в master. На 2026-10-06 PR слили красным, потому что запуск этой проверки в master был отменён и прочитан как красный. Теперь мерджер сам читает master, начиная с самого нового запуска: run_says учитывает только завершённое падение или успех, look_back пропускает всё остальное и запуски старше базы слияния, а discount_holds нужны слово пчелы и MASTER RED.

Попробовать

Сделайте все запуски отменёнными; затем передвиньте падение раньше базы слияния и посмотрите на ворота.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Inherited red: what master's runs say about a red check
Inherited red: what master's runs say about a red check ↗

The bee says a red check is red on master too. The merger reads master itself, newest run first: a cancelled run is looked past, and only a failure at or after the merge base discounts.

specs/queen/merger_gate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

Унаследованный красный

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/invariants/index.html b/apps/website/public/ru/learn/invariants/index.html index 7fb647f98f..397872cc20 100644 --- a/apps/website/public/ru/learn/invariants/index.html +++ b/apps/website/public/ru/learn/invariants/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Инварианты и замеры

Вы узнаете

Как пишутся блоки invariant и bench и кто их вычисляет.

invariant с именем и следующим assert задаёт правило спеки, которое верно для любого значения, а не для одного примера. bench с именем отмечает блок для замера времени. Оба компилируются. Тестовый прогон этого сайта вычисляет только блоки test: инварианты и замеры он пропускает, так что ложный инвариант здесь проходит молча. Поэтому спека урока повторяет свой инвариант тестом.

Попробуйте

Сделайте инвариант ложным в плеере и убедитесь, что этот сайт молчит, затем сделайте ложным тест.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 20: test, invariant and bench
t27 basics 20: test, invariant and bench ↗

The three kinds of checking block in t27 and which ones the site test runner evaluates. Lesson 20 of the t27 basics course.

specs/basics/20_invariants.t27

// SPDX-License-Identifier: Apache-2.0
@@ -82,6 +114,7 @@ 

Инварианты и замеры

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/io-timing/index.html b/apps/website/public/ru/learn/io-timing/index.html index 12751ec25d..95799c5665 100644 --- a/apps/website/public/ru/learn/io-timing/index.html +++ b/apps/website/public/ru/learn/io-timing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Тайминг выводов

Вы узнаете

Как тайминг выводов задаётся против клока, которым управляет другая микросхема, и как выглядят запасы, прочитанные из SDF.

Тайминг вывода задаётся против клока, которым ведёт другая микросхема: set_input_delay и set_output_delay, отрицательные до фронта, положительные после. Виджет показывает, как выглядят такие запасы, когда их читают, а не предполагают: два записанных прогона модели по разведённому дизайну E3 для платы AX7203 (XC7A200T в корпусе FBG484), напечатанные — минимальный TX hold 3445 пс на eth_txd[1], минимальный RX-запас между полубайтами 10900 пс на rxctl_n, оба PASS — модель по собственному SDF nextpnr о разведённом дизайне, а не измерение на плате, и она так и говорит. Окно спеки снова открывает emitter_xdc.t27, эмиттер, куда эти строки пошли бы.

Попробуйте

В виджете найдите минимальный TX hold и вывод, на котором он измерен; затем в окне спеки найдите, куда эмиттер поставил бы input- и output-задержки.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-txhold · RGMII margins from nextpnr's own SDF
tri fpga-txhold · RGMII margins from nextpnr's own SDF ↗

Two recorded model runs (2026-09-27 and 09-28), printed: smallest TX hold 3445 ps on eth_txd[1], smallest RX mid-nibble margin 10900 ps on rxctl_n, both PASS. A model over the routed design's SDF, not a board measurement.

specs/pins/emitter_xdc.t27

// SPDX-License-Identifier: Apache-2.0
@@ -362,6 +394,7 @@ 

Тайминг выводов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/jtag-asks-the-chip/index.html b/apps/website/public/ru/learn/jtag-asks-the-chip/index.html index 04c05d46e9..b3b7c8945a 100644 --- a/apps/website/public/ru/learn/jtag-asks-the-chip/index.html +++ b/apps/website/public/ru/learn/jtag-asks-the-chip/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

JTAG спрашивает чип

Вы узнаете

Как кабель находит чип на плате и читает его IDCODE.

JTAG — это протокол кабеля для разговора с чипом на плате. Перед прошивкой инструмент выдвигает IDCODE каждого устройства в цепочке. Эта запись декодирует коды, которыми отвечает наш стенд, и показывает, что значит чётный код: IDCODE нет вовсе. Сравните с декодером из урока 2.

Попробуйте

Найдите, какой IDCODE принадлежит XC7A200T, а какой XC7A100T. В спеке HELP_LINE говорит, как tri fpga-jtag читает цепочку без ответа: что он винит, если пришли все единицы, а что — если все нули?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-jtag · which chip answered the cable
tri fpga-jtag · which chip answered the cable ↗

IDCODEs decoded offline: 0x03636093 is an XC7A200T, 0x13631093 an XC7A100T, and an even code is no IDCODE at all (BYPASS or a broken shift). Self-test: 17 of 17 ok.

specs/tools/trios/tri/fpga-jtag.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

JTAG спрашивает чип

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/kill-the-mutant/index.html b/apps/website/public/ru/learn/kill-the-mutant/index.html index 76ef397392..8fb91e9ae7 100644 --- a/apps/website/public/ru/learn/kill-the-mutant/index.html +++ b/apps/website/public/ru/learn/kill-the-mutant/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Убить мутанта

Вы научитесь

Как мутационное тестирование переворачивает игру: ломайте дизайн нарочно и смотрите, заметят ли тесты.

Мутационное тестирование переворачивает всю игру: вместо вопроса «проходят ли тесты» — сломайте дизайн нарочно и спросите, заметили ли тесты. Виджет — инструмент, делающий это с трактом битстрима: посадить баг и смотреть, как тесты его ловят, а spec урока — команда, которой принадлежит посадка. Набор тестов, который всё проходит и не ловит ни одного мутанта, — набор, который не может упасть, а набор, который не может упасть, ничего не охраняет.

Попробуйте

Посадите баг инструментом мутаций и посмотрите, какой тест его поймает; затем найдите в spec место, где посаженная неисправность названа.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri x7-mutate · plant a bug, the tests must catch it
tri x7-mutate · plant a bug, the tests must catch it ↗

Five planted bugs in packets.t27 (CRC polynomial bit, CRC address width, LFRM no-ops, COR0 bit 0, type-2 word count). Each mutant is rebuilt and re-swept; every one is CAUGHT by its tests and by the sweeps. mutate: all 5 caught.

specs/tools/trios/tri/x7-mutate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Убить мутанта

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/kleene-logic/index.html b/apps/website/public/ru/learn/kleene-logic/index.html index 662aa22741..ed3ee76535 100644 --- a/apps/website/public/ru/learn/kleene-logic/index.html +++ b/apps/website/public/ru/learn/kleene-logic/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Трёхзначная логика

Вы узнаете

Как NOT, MIN и MAX расширяют булеву логику значением «не знаю».

Пусть -1 — ложь, +1 — истина, 0 — «не знаю». Тогда И — это минимум, ИЛИ — максимум, а НЕ — переворот: сильная логика Клини. В четырёх углах каждой таблицы 3 x 3, где нет неизвестного входа, это в точности булева логика; средние строка и столбец показывают, что знает схема, когда вход неизвестен. Спека урока записывает их как t_not(), t_min() и t_max(), а её тесты проверяют булевы углы.

Попробовать

Найдите клетки MIN, где неизвестный вход не меняет ответ, и такие же клетки MAX.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Three-valued logic: NOT, MIN and MAX
Three-valued logic: NOT, MIN and MAX ↗

False, unknown, true as -1, 0, +1. AND is the minimum, OR the maximum, NOT a flip; on -1 and +1 alone they are Boolean logic.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Трёхзначная логика

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/lamb-and-large-batches/index.html b/apps/website/public/ru/learn/lamb-and-large-batches/index.html index 3a6803d768..a4a405814e 100644 --- a/apps/website/public/ru/learn/lamb-and-large-batches/index.html +++ b/apps/website/public/ru/learn/lamb-and-large-batches/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

LAMB и большие пакеты

Вы узнаете

Как LAMB масштабирует шаг каждого слоя его собственной нормой весов, чтобы один шаг обучения подходил слоям любого размера.

Обучение на очень больших пакетах требует большого шага обучения, а один шаг может быть слишком большим для малого слоя и слишком малым для большого. LAMB берёт обновление в духе Adam для каждого слоя и перемасштабирует его коэффициентом доверия, нормой весов слоя, ограниченной 10, делённой на норму обновления, поэтому каждый слой сдвигается на одну и ту же долю самого себя. В спеке веса (1, 2), умноженные на масштаб, делают шаг с нормой, в 0.001 раз меньшей их собственной: 0.00447 при масштабе 2, а когда норма весов переходит 10, около масштаба 4.47, шаг остаётся на 0.01. Спека lamb.t27 вычисляет обновление для одного слоя и для двух сразу.

Попробовать

Прочитайте шаг при масштабах 1 и 2 и сравните; затем перетащите за изгиб и объясните, почему линия становится плоской.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

LAMB: one learning rate for layers of every size
LAMB: one learning rate for layers of every size ↗

Scale a layer's weights and watch its LAMB step: it grows with the weight norm, so every layer moves by the same fraction of itself, until the norm passes 10 and the step stops growing.

specs/ml/optimizer/lamb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -314,6 +346,7 @@ 

LAMB и большие пакеты

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/latency/index.html b/apps/website/public/ru/learn/latency/index.html index 1d4ea37fc5..8e53b85c76 100644 --- a/apps/website/public/ru/learn/latency/index.html +++ b/apps/website/public/ru/learn/latency/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Задержка

Вы узнаете

В скольких тактах память отвечает и что стенд памяти проверяет в чтении и записи.

Каждый ответ стоит тактов, и перечисление MemLatency спеки несёт типы, которые должно покрывать состояние ожидания. Стенд проверяет поведение: test_reset_clears, test_write_read_single, test_write_read_multiple, test_overwrite, test_all_zero_bits, девять тестов. Запись опускает тестбенч-спеку памяти в Verilog.

Попробовать

В записи найдите тесты стенда; затем в спеке найдите типы MemLatency и скажите, что должно покрывать состояние ожидания.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on memory_tb.t27 -- the testbench as RTL
t27c gen-verilog on memory_tb.t27 -- the testbench as RTL ↗

The memory testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/memory_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -236,6 +268,7 @@ 

Задержка

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/learning-xor/index.html b/apps/website/public/ru/learn/learning-xor/index.html index 5c13106d59..4373f84c34 100644 --- a/apps/website/public/ru/learn/learning-xor/index.html +++ b/apps/website/public/ru/learn/learning-xor/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Учим XOR

Вы узнаете

Почему один нейрон не может выучить XOR и как это делает скрытый слой, обученный обратным распространением.

XOR равен 1, когда ровно один из двух входов равен 1. Никакая прямая не отделяет случаи, дающие 1, от дающих 0, поэтому один нейрон выучить его не может. Скрытый слой изгибает пространство: спека обучает сеть 2-8-1 из ReLU обратным распространением, lr 0.05, из фиксированных начальных весов. Её потеря падает с 0.8896 в эпохе 1 до 1.8e-13 после 2000 эпох, а четыре ответа выходят в пределах 4e-7 от 0, 1, 1 и 0. Виджет проводит это обучение в вашем браузере, заново для каждой точки кривой. Спека mlp.t27 хранит сеть и тест, что она учится.

Попробовать

Отведите эпохи назад к 100 и прочитайте четыре ответа; затем найдите эпоху, где кривая перестаёт падать.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

XOR: a network learns what one neuron cannot
XOR: a network learns what one neuron cannot ↗

A 2-8-1 network trained by backpropagation in your browser: drag the epochs from 0 to 2000 and watch its four answers move to 0, 1, 1, 0 while the loss falls from 0.89 by twelve orders.

specs/ml/pathway/mlp.t27

// SPDX-License-Identifier: Apache-2.0
@@ -392,6 +424,7 @@ 

Учим XOR

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/line-and-toggle/index.html b/apps/website/public/ru/learn/line-and-toggle/index.html index c2a58c3594..8f69a6a13d 100644 --- a/apps/website/public/ru/learn/line-and-toggle/index.html +++ b/apps/website/public/ru/learn/line-and-toggle/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Строки и переключения

Вы научитесь

Как построчное покрытие и покрытие переключений считают, чего прогон коснулся, бит за битом.

Построчное покрытие спрашивает: исполнялась ли эта строка? Покрытие переключений спрашивает острее, по битам: этот сигнал когда-нибудь шёл из 0 в 1, а когда-нибудь из 1 в 0? Застрявший сигнал может всю жизнь просидеть под 100 % построчного покрытия. Spec урока — coverage.t27: точки со счётчиками срабатываний, проценты по видам и запретные дуги, обязанные оставаться на нуле, — с 26 тестами и 4 инвариантами собственной персоной. Виджет показывает полосами ресурсы настоящего дизайна; полосы покрытия — та же картинка, только по тому, чего прогон коснулся.

Попробуйте

Посчитайте точки в тесте fsm_report из coverage.t27 и проверьте процент вручную; затем найдите в виджете ресурсов сигнал, который счётчик переключений пометил бы.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Resource bars: LUT, FF, BRAM and DSP used on the XC7A200T
Resource bars: LUT, FF, BRAM and DSP used on the XC7A200T ↗

A real nextpnr-xilinx run counted against the XC7A200T's own totals, read from the chipdb and prjxray-db. Drop your routed JSON and it counts yours.

specs/fpga/coverage.t27

// SPDX-License-Identifier: Apache-2.0
@@ -574,6 +606,7 @@ 

Строки и переключения

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/lite-or-full/index.html b/apps/website/public/ru/learn/lite-or-full/index.html index 2395d87141..f51f604ee5 100644 --- a/apps/website/public/ru/learn/lite-or-full/index.html +++ b/apps/website/public/ru/learn/lite-or-full/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Lite или full

Вы узнаете

Что AXI4 Lite оставляет и что выбрасывает, и чего валидация требует от шины.

Lite — то же рукопожатие с вынутой механикой пакетов: без LEN, без лестницы размеров, одна пересылка за раз. Перечисление AxiKind спеки несёт lite и full, и её тесты называют разницу — axi4_lite_is_lite, axi4_full_is_full — и правила валидации: validate_lite_ok, validate_full_ok, validate_empty_name, validate_zero_addr. Запись прогоняет t27c check по спеке: 0 ошибок, 0 предупреждений.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите значения AxiKind и четыре теста валидации.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c check on axi4.t27 -- the spec compiles
t27c check on axi4.t27 -- the spec compiles ↗

t27c check typechecks the AXI4 spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/axi4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -461,6 +493,7 @@ 

Lite или full

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/local-names/index.html b/apps/website/public/ru/learn/local-names/index.html index 2f95789526..8d7aa02497 100644 --- a/apps/website/public/ru/learn/local-names/index.html +++ b/apps/website/public/ru/learn/local-names/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Локальные имена: let и var

Вы узнаете

Когда нужен let, а когда var и как обновляется var.

let a = w * h; даёт имя значению внутри тела функции. var i : u8 = 0; объявляет имя, которое может меняться, а i = i + 1; меняет его. let нужен, когда значение вычисляется один раз, var — когда его обновляет цикл. Эти имена живут только внутри функции; на уровне модуля используется const.

Попробуйте

Замените let на var в area и проверьте вердикт; потом объясните, почему там уместнее let.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 13: let, var and const
t27 basics 13: let, var and const ↗

Where let, var and const live in a t27 spec and whether the name may change. Lesson 13 of the t27 basics course.

specs/basics/13_local_names.t27

// SPDX-License-Identifier: Apache-2.0
@@ -92,6 +124,7 @@ 

Локальные имена: let и var

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/logic-depth/index.html b/apps/website/public/ru/learn/logic-depth/index.html index 9411b9100e..da7f6e31d8 100644 --- a/apps/website/public/ru/learn/logic-depth/index.html +++ b/apps/website/public/ru/learn/logic-depth/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Глубина логики

Вы узнаете

Почему самая длинная цепочка логики задаёт, насколько быстро может работать дизайн.

Сигналу нужно время, чтобы пройти каждую LUT и каждый провод. Самая длинная цепочка логики между двумя регистрами задаёт, как часто может тикать такт. yosys может показать эту цепочку как число ячеек ещё до трассировки. Лестница рисует её для настоящего сумматора GF16, шаг за шагом.

Попробуйте

Откройте настоящий пример и посчитайте, сколько шагов пути — это LUT. В спеке est_comb_delay берёт 100 пс за каждую LUT и ещё 300 пс на трассировку: найдите тест, который получает 600 для трёх LUT.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

LUT depth: your longest yosys path, drawn as a staircase
LUT depth: your longest yosys path, drawn as a staircase ↗

Paste yosys ltp -noff output: the longest path after LUT mapping, one step per cell, typed when a dump is in the text. A cell count, not nanoseconds. Read in your browser.

specs/fpga/timing.t27

// SPDX-License-Identifier: Apache-2.0
@@ -446,6 +478,7 @@ 

Глубина логики

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/long-multiplication/index.html b/apps/website/public/ru/learn/long-multiplication/index.html index 94f66a59b6..e99ca11dbb 100644 --- a/apps/website/public/ru/learn/long-multiplication/index.html +++ b/apps/website/public/ru/learn/long-multiplication/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Умножение столбиком

Вы узнаете

Как n x m превращается в строки копий, нулей и переворотов.

Каждый трит m выбирает копию, ноль или переворот n, сдвинутый на разряд в каждой строке; сумма строк и есть произведение. 7 x 8: 8 — это +0-, поэтому строки равны -7, 0 и 63, а их сумма 56. Таблицу умножения учить не нужно: только переключатель прошлого урока и сумматор. long_mul() спеки сверяется с n x m на 243 парах.

Попробовать

Найдите пару, у которой средняя строка — копия, а остальные строки — нули; затем умножьте 13 на 13.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Long multiplication in balanced ternary
Long multiplication in balanced ternary ↗

Each trit of m picks a copy, a zero or a flip of n, shifted one place per row. Add the rows: that is the product.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Умножение столбиком

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/loops/index.html b/apps/website/public/ru/learn/loops/index.html index f893bda896..72d69a008b 100644 --- a/apps/website/public/ru/learn/loops/index.html +++ b/apps/website/public/ru/learn/loops/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Циклы: while и for

Вы узнаете

Три формы цикла, которые принимает компилятор, и как пишется диапазон.

while (i < n) { i = i + 1; } повторяет блок, пока условие истинно, и блок обязан приближать момент, когда оно станет ложным. for i in 0..n { } проводит i от 0 до n, не включая само n. Компилятор принимает и форму Zig: for (0..4) |i| { }. Цикл обычно обновляет var, объявленную перед ним.

Попробуйте

Посчитайте вручную, что вернёт sum_to при n = 4, и запишите это константой с тестом.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 15: three loop forms
t27 basics 15: three loop forms ↗

while, for in a range and the Zig-style for, each checked with the real t27 compiler, and a range drawn step by step. Lesson 15 of the t27 basics course.

specs/basics/15_loops.t27

// SPDX-License-Identifier: Apache-2.0
@@ -95,6 +127,7 @@ 

Циклы: while и for

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/lowering-the-rate/index.html b/apps/website/public/ru/learn/lowering-the-rate/index.html index 8adcc761a2..30a91839f3 100644 --- a/apps/website/public/ru/learn/lowering-the-rate/index.html +++ b/apps/website/public/ru/learn/lowering-the-rate/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Понижение частоты

Вы узнаете

Что сохранение каждого R-го отсчёта делает со спектром и какие частоты заворачиваются в оставляемую полосу.

Оставьте каждый R-й отсчёт, и частота упадёт до fs/R, а каждая частота около кратного новой частоты окажется около 0. Проредите 400 в 4 раза, и тон на 95 попадёт на 5, прямо в полосу шириной 10. Виджет закрашивает каждую входную частоту, которая завернётся в полосу: именно это должен убрать фильтр перед дециматором, и поэтому там, где ничего не заворачивается, этот фильтр может быть дешёвым. Спека signals.t27 вычисляет каждый заворот.

Попробовать

При R = 4 и полосе 10 найдите красные зоны и поставьте тон в каждую; затем увеличьте R и посмотрите, как зон становится больше.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Decimation: lower the rate without folding noise in
Decimation: lower the rate without folding noise in ↗

Pick a decimation factor and a band to keep. See every input frequency that would fold onto that band, and where a tone lands after the rate drops.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Понижение частоты

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/lstm-gates/index.html b/apps/website/public/ru/learn/lstm-gates/index.html index 5e166850d7..8bdc470db4 100644 --- a/apps/website/public/ru/learn/lstm-gates/index.html +++ b/apps/website/public/ru/learn/lstm-gates/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Вентили LSTM

Вы узнаете

Как вентили забывания, входа и выхода LSTM решают, что ячейка хранит, записывает и показывает.

Ячейка LSTM хранит отдельную память c и три вентиля, каждый это сигмоида между 0 и 1: забывание масштабирует старую память, вход впускает новое содержимое g, а выход решает, сколько памяти показать. c' = f c + i g и h' = o tanh(c'). В фикстуре спеки каждый вес равен 0, поэтому каждый вентиль это сигмоида своего смещения: при вентиле забывания 0.9975 и вентиле входа 0.0025 память 1 выходит как 0.9975, а выход равен 0.7587. Так как c проходит лишь с умножением на f, её градиент тоже переживает много шагов. Спека lstm_single.t27 вычисляет ячейку.

Попробовать

Загрузите Remember, а затем Forget и сравните новую память; затем запишите с открытым вентилем входа.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

LSTM gates: how a cell decides what to keep
LSTM gates: how a cell decides what to keep ↗

Set the biases of the forget, input and output gates and the old memory: the new memory is forget x old + input x candidate, and the output shows tanh of it through the output gate.

specs/ml/recurrent/lstm_single.t27

// SPDX-License-Identifier: Apache-2.0
@@ -393,6 +425,7 @@ 

Вентили LSTM

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/lucas-numbers-stay-whole/index.html b/apps/website/public/ru/learn/lucas-numbers-stay-whole/index.html index daafa1b681..be0bbd08d6 100644 --- a/apps/website/public/ru/learn/lucas-numbers-stay-whole/index.html +++ b/apps/website/public/ru/learn/lucas-numbers-stay-whole/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Числа Люка остаются целыми

Вы узнаете

Почему phi^(2n) + phi^(-2n) всегда целое число и откуда берётся 3 в phi^2 + 1/phi^2 = 3.

phi иррационально, но phi^2 + phi^(-2) равно ровно 3. Это не случайность: phi^k + (-1/phi)^k — число Люка L_k, а числа Люка целые: 2, 1, 3, 4, 7, 11, 18 и дальше, каждое — сумма двух предыдущих. Спека считает phi^(2n) + phi^(-2n) в f64 и сверяет с L_2n для n от 0 до 6 с допуском 1e-9. Число 3 из девиза проекта — это L_2.

Попробуйте

Запустите тесты и прочитайте лестницу от n = 0 до n = 6. Затем найдите инвариант, который называет TRINITY числом L_2, и допуск, который позволяет сравнение в f64.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 3: Lucas numbers stay whole
GoldenFloat 3: Lucas numbers stay whole ↗

phi^(2n) + phi^(-2n) against L_2n, read from lucas_accumulator.t27. Lesson 3 of the GoldenFloat course.

specs/numeric/lucas_accumulator.t27

// SPDX-License-Identifier: Apache-2.0
@@ -205,6 +237,7 @@ 

Числа Люка остаются целыми

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/many-tests/index.html b/apps/website/public/ru/learn/many-tests/index.html index 2b6099f9e8..4fe7469cd7 100644 --- a/apps/website/public/ru/learn/many-tests/index.html +++ b/apps/website/public/ru/learn/many-tests/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Много тестов в одной спеке

Вы узнаете

Почему несколько маленьких тестов читаются проще одного длинного и как отчёт их считает.

Спека может держать сколько угодно блоков test. Каждый проверяет одну мысль и носит имя, которое её называет. Отчёт считает тесты и assert отдельно: в спеке урока 3 теста и 5 assert. Когда один падает, его имя говорит, какая мысль сломалась, а остальные тесты по-прежнему отчитываются о своих.

Попробуйте

Сделайте так, чтобы один из трёх тестов упал, и проверьте, что два других проходят.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 11: three tests, one idea each
t27 basics 11: three tests, one idea each ↗

The tests of a t27 spec counted one by one, with the asserts in each, from the lesson spec. Lesson 11 of the t27 basics course.

specs/basics/11_many_tests.t27

// SPDX-License-Identifier: Apache-2.0
@@ -91,6 +123,7 @@ 

Много тестов в одной спеке

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/master-and-servant/index.html b/apps/website/public/ru/learn/master-and-servant/index.html index 4ae0bc6202..61222c2a93 100644 --- a/apps/website/public/ru/learn/master-and-servant/index.html +++ b/apps/website/public/ru/learn/master-and-servant/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Хозяин и слуга

Вы узнаете

Что такое шина регистров, кто ведёт и кто отвечает, и как APB называет роли.

Шина регистров задаёт разговору роли: один хозяин выставляет адреса, каждый слуга отвечает, когда его назвали. APB — эта шина в самом простом виде, а спека урока — её мост: ApbBridge с APB_ADDR_WIDTH 32, APB_DATA_WIDTH 32 и APB_STRB_WIDTH 4. Запись прогоняет t27c check: 0 ошибок, 0 предупреждений. Следующий через один модуль разбирает её рукопожатие по фазам.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите три ширины APB и скажите, что покрывает ширина строоба 4.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c check on apb_bridge.t27 -- the spec compiles
t27c check on apb_bridge.t27 -- the spec compiles ↗

t27c check typechecks the APB bridge spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/apb_bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -415,6 +447,7 @@ 

Хозяин и слуга

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/max-pooling/index.html b/apps/website/public/ru/learn/max-pooling/index.html index 44932debca..0301d0449e 100644 --- a/apps/website/public/ru/learn/max-pooling/index.html +++ b/apps/website/public/ru/learn/max-pooling/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Max pooling: максимум окна

Вы узнаете

Что оставляет max pooling, откуда, как он помнит, это взято и куда идёт градиент.

Max pooling оставляет наибольшее значение каждого окна и отбрасывает остальные, поэтому сети становится менее важно, где именно лежит признак. На сетке спеки 4 x 4 окна 2 x 2 с шагом 2 оставляют 4, 8, 9 и -2, взятые из клеток 5, 6, 13 и 11. Перекрывающиеся окна 3 x 3 с шагом 1 оставляют 8, 8, 9 и 9. При обратном проходе весь градиент окна идёт в его максимум: градиенты 1, 2, 3 и 4 попадают в клетки 5, 6, 13 и 11, а все остальные клетки получают 0. Спека maxpool2d_layer.t27 вычисляет выходы, их позиции и градиент.

Попробовать

Переключитесь на окна 3 x 3 и найдите клетку, общую для двух выходов; затем включите градиент для окон 2 x 2.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Max pooling: what a network keeps when it shrinks a picture
Max pooling: what a network keeps when it shrinks a picture ↗

Pick a window size and stride and tap an output: max pooling keeps the largest value of its window and remembers where it was, and the gradient later goes to that one cell.

specs/ml/layers/maxpool2d_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -237,6 +269,7 @@ 

Max pooling: максимум окна

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/mean-squared-error/index.html b/apps/website/public/ru/learn/mean-squared-error/index.html index ccad6c6b03..5fddfe0efc 100644 --- a/apps/website/public/ru/learn/mean-squared-error/index.html +++ b/apps/website/public/ru/learn/mean-squared-error/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Среднеквадратичная ошибка

Вы узнаете

Как MSE превращает каждый промах в одно число, почему она гоняется за большими ошибками и куда смотрит её градиент.

Функция потерь превращает все промахи модели в одно число, которое нужно уменьшать. Среднеквадратичная ошибка усредняет квадраты промахов: предсказания 1.5, 2 и 2 против целей 1, 2 и 3 стоят (0.25 + 0 + 1) / 3 = 0.4167. Из-за квадрата промах на 2 стоит в 4 раза больше промаха на 1, поэтому MSE гоняется за большими ошибками. Её градиент для каждого предсказания равен 2 (p - t) / n, здесь 0.333, 0 и -0.667: каждое предсказание толкается обратно к своей цели. Как функция одного предсказания потеря это парабола, чаша с одним дном. Спека mse_loss.t27 вычисляет потерю и градиент.

Попробовать

Передвиньте предсказание 2 на его цель и прочитайте потерю; затем ведите по чаше и найдите её дно.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Mean squared error: how wrong a guess is, as one number
Mean squared error: how wrong a guess is, as one number ↗

Move three predictions against the targets 1, 2 and 3: the loss is the mean of the squared misses, its bowl is a parabola, and each gradient points its prediction back at the target.

specs/ml/loss/mse_loss.t27

// SPDX-License-Identifier: Apache-2.0
@@ -166,6 +198,7 @@ 

Среднеквадратичная ошибка

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/memory-maps/index.html b/apps/website/public/ru/learn/memory-maps/index.html index 5f8ce16e7c..80062bf4ae 100644 --- a/apps/website/public/ru/learn/memory-maps/index.html +++ b/apps/website/public/ru/learn/memory-maps/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Карты памяти

Вы узнаете

Как объявляется карта памяти, что значат BRAM и ROM как типы и что проверяют 15 нативных тестов.

Карта памяти — это кто живёт по какому адресу: перечисление MemKind спеки несёт типы, а make_bram_has_depth, make_bram_small и make_bram_single — три из её пятнадцати тестов. Запись — нативный прогон: спека памяти через настоящий t27c, 15 тестов проходят и 6 инвариантов доказаны comptime — из всего семейства шин нативный раннер берёт её целиком, больше ни одну так.

Попробовать

В записи посчитайте проходящие тесты и доказанные инварианты; затем в спеке найдите значения MemKind и три теста make_bram.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on memory.t27 -- the memory map, native
t27c on memory.t27 -- the memory map, native ↗

t27c test-report on the memory spec: 15 tests pass natively and 6 invariants are proved comptime -- address decode, wait states and access sizes.

specs/fpga/memory.t27

// SPDX-License-Identifier: Apache-2.0
@@ -422,6 +454,7 @@ 

Карты памяти

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/modes-cpol-cpha/index.html b/apps/website/public/ru/learn/modes-cpol-cpha/index.html index d948e5760b..d5e15b494b 100644 --- a/apps/website/public/ru/learn/modes-cpol-cpha/index.html +++ b/apps/website/public/ru/learn/modes-cpol-cpha/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Режимы: CPOL и CPHA

Вы узнаете

Что значат CPOL и CPHA, почему режимов четыре и какой конфигурирует спека.

CPOL выбирает уровень покоя такта, CPHA — какой фронт стробирует: четыре комбинации, четыре режима, и устройства, говорящие только на одном. Спека конфигурирует режим 0 — SPI_CPOL 0, SPI_CPHA 0 — и spi_mode_0_configuration это тест, который его прикалывает. Запись опускает спеку SPI в синтезируемый Verilog.

Попробовать

В записи найдите порты модуля, которые Verilog даёт мастеру SPI; затем в спеке найдите тест режима 0 и назовите, что выбирает каждый из CPOL и CPHA.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on spi.t27 -- spec to RTL
t27c gen-verilog on spi.t27 -- spec to RTL ↗

The compiler lowers the SPI spec to synthesizable Verilog: the TRINITY banner, the module port list and the datapath as wires.

specs/fpga/spi.t27

// SPDX-License-Identifier: Apache-2.0
@@ -474,6 +506,7 @@ 

Режимы: CPOL и CPHA

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/mtbf/index.html b/apps/website/public/ru/learn/mtbf/index.html index ab1bb245e5..48f75218f2 100644 --- a/apps/website/public/ru/learn/mtbf/index.html +++ b/apps/website/public/ru/learn/mtbf/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Среднее время между отказами

Вы узнаете

Как MTBF назначает пересечению цену в целочисленной арифметике log2 и какие константы в ней допущения.

MTBF назначает пересечению цену: e^(T/tau), делённое на F_clk, F_data и окно W, — форма, которой учит Xilinx WP323. mtbf.t27, написанная для этого курса, считает её в целочисленном log2 с 10 дробными битами, потому что честный ответ переполняет любой целочисленный счёт секунд. tau 50 пс и W 10 пс помечены как допущения: вендоры публикуют параметры триггеров лишь частично. На приёме 100 МГц потока 10 МГц 1 ступень оставляет -200 пс запаса и Q10 log2-MTBF -19513 — меньше двух микросекунд; 2 ступени оставляют 9800 пс и 275887 — дольше любых часов, которые вселенная успеет протикать. Запись запускает нативный t27c: проходят 15 тестов, 4 инварианта comptime.

Попробуйте

В записи найдите grep, перечисляющий допущения; затем в окне спеки посчитайте, что сулит stage_gain_q10() на 100 МГц за ещё один триггер.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on mtbf.t27 -- MTBF in integer log2, native
t27c on mtbf.t27 -- MTBF in integer log2, native ↗

t27c 0.4.0 on a laptop (macOS): 15 tests pass natively -- the WP323 form in Q10 log2, one flop negative slack, two flops astronomical, and the grep that shows the assumptions.

specs/fpga/mtbf.t27

// SPDX-License-Identifier: Apache-2.0
@@ -328,6 +360,7 @@ 

Среднее время между отказами

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/multiply-and-divide/index.html b/apps/website/public/ru/learn/multiply-and-divide/index.html index 55eea0ce9c..c6f68ffacb 100644 --- a/apps/website/public/ru/learn/multiply-and-divide/index.html +++ b/apps/website/public/ru/learn/multiply-and-divide/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Умножить и поделить

Вы узнаете

Как MMCM превращает один тактовый сигнал в другой умножением и делением и в какие окна должны попасть числа.

MMCM превращает один тактовый сигнал в другой: вход делится на D, умножается на M во внутренний VCO, а VCO делится на O для выхода. mmcm.t27, написанная для этого курса, хранит M в восьмых долях, чтобы дробные шаги остались целыми: M от 2,000 до 64,000, D от 1 до 106, O от 1 до 128, и VCO обязан попасть в своё окно — здесь от 800 до 1600 МГц, учебное допущение, которое шапка помечает рядом с диапазонами из UG472. Со входа 200 МГц, M 5, D 1: VCO 1000 МГц, и O 10 даёт на выходе 100 МГц. Запись запускает нативный t27c: проходят 16 тестов, 4 инварианта comptime.

Попробуйте

В записи найдите конфигурацию на 500 МГц, которую называет тест-отказник; затем в окне спеки найдите, какие диапазоны шапка берёт из UG472, а какие помечены как допущения.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on mmcm.t27 -- the MMCM model, native
t27c on mmcm.t27 -- the MMCM model, native ↗

t27c 0.4.0 on a laptop (macOS): 16 tests pass natively -- VCO window, M/D/O ranges, fractional multiply in eighths, the 1/56 VCO-period phase step, and the lock window.

specs/fpga/mmcm.t27

// SPDX-License-Identifier: Apache-2.0
@@ -339,6 +371,7 @@ 

Умножить и поделить

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/multiply-then-add/index.html b/apps/website/public/ru/learn/multiply-then-add/index.html index 5f535ab6da..a5d80f1405 100644 --- a/apps/website/public/ru/learn/multiply-then-add/index.html +++ b/apps/website/public/ru/learn/multiply-then-add/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Умножить, потом сложить

Вы узнаете

Что умножение с накоплением делает с двумя произведениями со знаком и как его ломает замена из урока 12.

Нейрон суммирует произведения весов на входы, и on_comb в gft_signed_mac.t27 — такая сумма из двух слагаемых: smul(a1, b1) плюс smul(a2, b2). Здесь smul ставит знак через XOR и не проверяет ноль. Нативный t27c запускает 4 теста, и все проходят; один из них, zero_clause, ждёт, что 0 x 1 + 0 x 1 даст 512, то есть 2^-39, а не 0, и комментарий называет это задуманным поведением. Браузер пропускает свои тесты, потому что его исполнитель пока не знает assert_eq. Запись запускает t27c test-report, затем повторяет ошибку урока 12 однострочным sed, который меняет XOR на OR, и снова запускает t27c test-report. Падает ровно один тест, pp: (-1.0) x (-1.0) теперь выходит отрицательным, и сумма равна 0 вместо 2.0. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи тест, который ждёт 512, и тест, который ломает подложенная ошибка; затем сами замените в спеке XOR в smul на OR и посмотрите, поймает ли это браузер.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_signed_mac.t27 -- multiply, then add, native
t27c on gft_signed_mac.t27 -- multiply, then add, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; OR in place of the sign XOR makes exactly one test fail, pp; git restores the spec.

specs/ternary/gft_signed_mac.t27

module GftSignedMac;
@@ -237,6 +269,7 @@ 

Умножить, потом сложить

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/negate-twice/index.html b/apps/website/public/ru/learn/negate-twice/index.html index cd18ddf6e2..82a4d152a6 100644 --- a/apps/website/public/ru/learn/negate-twice/index.html +++ b/apps/website/public/ru/learn/negate-twice/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Дважды сменить знак — получить число обр

Вы узнаете

Как тест свойства ловит ошибку в один символ, которую пропускает единичный пример.

Браузер пропустил 24 проверки tnf17.t27; нативный t27c запускает все 34 теста, все проходят, и ни один не пустой. Смена знака переворачивает бит знака через XOR. Запись меняет XOR на OR — ошибка в один символ. Смена знака у положительного числа по-прежнему выглядит верно, поэтому тест, который меняет знак у единицы, всё ещё проходит. Но отрицательное число теперь остаётся отрицательным, и двойная смена знака больше не возвращает исходное число. Падает ровно один тест, negate_is_an_involution, — тот, что формулирует это свойство. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите, сколько проходов были пустыми; затем вернитесь к плееру прошлого урока, сами замените XOR на OR и посмотрите, поймает ли это и браузер.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on tnf17.t27 -- a 17-bit ternary-exponent float, native
t27c on tnf17.t27 -- a 17-bit ternary-exponent float, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 34 tests pass natively; negating with OR instead of XOR fails exactly one test, the involution; git restores the spec.

specs/numeric/tnf17.t27

// SPDX-License-Identifier: Apache-2.0
@@ -434,6 +466,7 @@ 

Дважды сменить знак — получить число обр

Открыть спеку урока в плеере ↗

Все уроки

+

diff --git a/apps/website/public/ru/learn/neural-networks/all/card.png b/apps/website/public/ru/learn/neural-networks/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..455f9f6de43c043e24d7873ab91fde297537f58f GIT binary patch literal 48362 zcmeFYRZv{f+wMt1f@>hbAq0m20YZ?*3GNmgLLj)i6C@Da-D%w2B|z|?jk`C{NPxzn znVtO4_svwzxj1t%H>XZtP`jF4#olYZ_WYhjsIsCIHU=pM5)u-&jPyrUB&286NJvjz z(Vha|{CsnWiG+lQB=b>J-96)Q1ye-*>#Fb{HCPVLVnk=e@HBsZOaOfXg#J^GKUuxZ zD;uK<)2Yho{@v0xu^qa)X?g5C&rK?RhkP=H4OK2KHu`|8D0v43BEL;C&=@88vH z5$e~^{#~IdqoF*&(Ug!SD2G#rT6IaYs78a`IT*2VdBl1@r?xs#1J%g zEl==xn3YKaUhq5C=QC2hG{aW4YMD8G`gI4YW!-ICf44yL7l2yMekxiv<`Ib2B1ZsWW{UQj|p`X=_k z*5-5E(ci5ocW9=V&F^6TIEE{{%s$ClIsT`_iK^N5$F^H0VmFb2C*3dZo-22&Nd7|< zdF34L@%X$_cC}9F@Rj!$e)ofRdn<%%mBV^y?ec{kmC(rb%r_1<#Km!nKZB4#m+c*X zkuYezw&ZHnD>I9)YphPNVdkqvL zu*BP%D))XozA*AZ!HUlEu5h3|f{N_sUkt`FLl~%%sbbqd>3mQ-(5&BwHGwExPA=8= z`{C#vu4Bkd!F67So@X-;!hEk3J=guoE|~k-?!g8yFqzZQHoEcN3t~=X38Kguov*9s zLzK`m(}`<7%wysb#|u`oQUl#&P2b^t-Hx``iF(L~qSvs`tk2 z%>(Xz_g&pO#o!tWLmdz6)U5`=SL*eB-hPMicstgwe3Ch|SYo5{w9;SAT7`7+;7O4j zfew!EHx(c~I)1akee!vaabJQJ(k>HPF#3qBgbzl0mAK?al}2KV`R{^D)=~}iSbV(4C_&1)N=l+f z)zwD5l1ga}wq~lTl2i5An-JOV^{M;&a&&KJeZNCuFvSPYp882}YUT}sKlqofRBzhPIM(#;um=bj_CHGWt7 z5vXGJk(A%(L%fb*9hZrc{yDl^>}=<&6+-N+N>5lpqj}7|v-vm=gYg&C==V{?Cbmn% zLV=PJxJ7A2Gxc-KP9}=kyxo*3LJz3el)PHPu4gM?NuPvdUD}sxu1z#tpRZFk9$Ngc zNw~$XHe$iPrBb-fZ~3+iDqs5RkSTH@U(guub*bDgFCVe>Ah;Nm>h+Z#P*tjbT?e|6 zK}y%`!73-&*c-tCV8}6fP8?CXE$aELDKoJFM+DNT$3pW zDYV%vyI7ngVbN6mrqagBVg-4E2q>>wQ9HT!?+mt()2y9bUqD_;GG!fIb8>ZFoN{4- zNLt0$CKbLc>QJY9X_>K-4s!c?S~F|aeu1k(z7g%(-$@u9bvzJEXV%br8<|DO^|nct zS;l4TY>G9|;LGDo9J4V_dHVZ}sy5P;tPs_~|K< zFC>Df>gk1aH@l7dZa~p81Az@Ub@VH}s4+g+r%q1i`?PcwdVE%9ciwNv!pDYp^15#Y zTS%OeZSNu?CGT)LJZGm`j4rT{kgi8$Ah4(my=+mM!sS${f6bwi^(Ju3N z44sDsN4$$7HCctIp4f(>9=%dal%MK0xbR(-+qpmRL5Y;hTZ-FTEJu3dO)pUj6w8xF4c#&npXM6^8kw?*E_ zMs}%{QVeWHP*nN%?c4_7X5PCy{q;V}yryVdJP(qzYkiV|mjqr-T^c6*zng}zTCIB$ zIF5Q#vTFG^t6z271g0} zxO2AhR{mbM^#h0<=u-pc z)inSelXbQ6Ttt^hLZ@f<`>jO?`sz4Hv&&7Fjpgwh4b#lrJBwGzUzY2Jgimu!;rZxB zdc-exmT~?g0{#nLXGhYsg0iy((_tmIicCyOz z({;-4_)9IuURP6^?-q@W7F`SCjl@RKf3MUxF_>yTLGpZir`-wD$QJ6HLA~2IjzD1p zoAPf$HJ|!$ef~Y&cJhPdx2fcL7>;a+Az^yzTh}nOfu@f^KF;7TjFbXS^XdiljlP%L z_?1MukD>u-E>|GV2RJxb?VBaYx^mG@uvZe9=655vFTJrMBVTZ&legJ9+1uJ|p{1lbNoffO zCWmVABAH5{TERhJ5as&bLQr>{SD297DE>?HGxo0u9G+N6A`Ayy?$AcLPpBP$`paPn)gRO8dL8wGCG{B5dP#9@dWAH*rc8E zUW$y{Dqkv0v&pP0njP2a{jsGG4KJL# zqHG$_ASPKRKW-*uW1C&NaI5mklgc&Lbke3b!h1C$NXvJgwupXU|CfH)N##zCwKQ}(fb~y8;0k0R$T45eTyBvbjLl{XhCic55*Z*RPp^49yAO>I5kge| z5x;B)J+C7IEbeN}ENoNr?_FY~TkBb%_J3;M&abq1T9 zFX`m@oZoZ z)$Y7^6nh#p9COyhpqfyzWHvFV!jBPGR$6|zn#u3D_Y6$M`Q>+vFRI@etItePbQreC zVNWqsAURLAllzCz23?_Avx+HL`H#BW(Z?F|-Pjh+tWMhIX zX_sw>(|0L}ZDscZoP?j+hV(9nU-?jUTq1cM5pIMvX9S<;+a=#Yw@O6^_tMLw!P?5K zc7K}hn=@S(b!DuyS*)z0JDEi)>b5v9Wnm>#Q%eNhctQK+Q{MBiyp4!NZF<=jh1zTS zk}7@1cBm$kh3nIC&pQqzB>g^)qh}!AjxZ8|DPE(VSem6#M;E5adV<F8Kb!4aFDo1rFc&^PHL%QKk-FBlNxa&&kB#1 zK5F5nPRT>ie#OyUn~7&6SHNNX;WD-lN)<RFc#6>qoII?Mu2gSTGi)%;e7v9It`c zr>LP7xjB(#kPJRp_nJm~5v6T}F&O2~3b`NQ!6=a-`|)}fxw*_@x~x&mY2 z6ldcMg9U^22(e%|Cc3^0xy@(flL7+zNYiMQhcShv<*)X-yVNGlSE9Iw%k{SU2(y9b z*?gKxEuz7Zu6GwOIblvDqzR)%1rW#U=@iGS3XU4L6_?8d_&OW|c<^zzQCKh3J3;fe zV!aKvE?fn2}!C>5HbW%F{+p|2<#hxiZ# zK|d^*80#?jh^GxZTF0sY7{i5~&SGxjqvb>VUifr1N%a%Bj)Zuqo(Ia6^T(unkJ*;g z)(2?_YnQz>i!cs}Am=EKwo{vIpj}h%;gHvfb9r%7g9yB>>#!KlP{|Mg_9Dv;ONrZl z`&nc9*4^@9yzhay2LevgmR_H4$k_V2qZMUL{pGHVf;@Xwb{0j^72LOSsUiCc^tvz; zZT*`v!Dy6i4-T%=XGpn)HU>SJIfdfx;p)A&U!)?Rwet&}fuMIyeVvlUJ|$N4(!!lA zAXnuNkS7OL3r+9GGg%B$8<;GX%B!_m>Kczy@5US!aw0Ng?9CqXX&aS}vJ^lo5=DyV zc&+x0Nj@I-DM?<56Fo>sB2eB($fV%+C8>yZP%uU4BbWwNaBvzeqcN+NOMKp0fvUeP zZSf{M>d*sLu@USQi7Z7Th4ubU!0?U@;R1=FcJixi8E` z91d41yK`5zsF=Q@*^)wr8^f)MK0R!=?JAmU&zik%`voo88_O2B^>SYkB0NQ+a~gV}Qurdos6i`wH%-}9^& zJaet|#D>Ua))7|er75W_>_sHXF<`qim>y+)agCDRogcf;^d0{6fqcp78^v#K`jRW0 zT@0iNg-k(*ZQ25M6daPnk&hSX*{fgx{a|agIZL%FUnH?mY?;&?S^Cp|4w#f5GNfHR0Sl9z;9_(nj+HKR)DeY*DO`KNMY1k_lN#&na20Nyh+4KupXy0T@|aBQD4pZai0Ijn;GT3VpVv``U&gx`3aWoN z_-yvtWUG5o0TQe~k!PqyO2*6qW`OV7@91eDrV5s>W8T3~ZeprWs#DOHiOZK9!yjh- zXKNXShud`OfsULonKt!$hB{pVx`R;i$tG9l!P!|Sq3E;G<;^FPkUybr;@ei5q| zl?f2*e_H6zC}kFwM<1c)AdtNEvqc?uKIESGlGDv=nzQm{G2DH^>IpF(PKVJ~M4>i# z!DDC#Dv^9WpRc_P#0M@ju|fSwu{P|(*8(~^h4eNHwb^H>#etEoJ+}^OQ&jfy-`tPq zR|QeW9P99-C}+b7w4kLQSoK@tT|vQOJ?{H7({nKi4exD;om`=<%Ywd#LSF6eE5n^;xNupqKB=S5cgmKopd~lf8hy<7%oq65osRPV8(s_;|lrs(xtD-7k1&Til!)B z7xHbPK(@BaOWl4q)7@rp)st0`2fV}wX%7u{Qg|KY`6?)=f{EdSXhOre)~7bZ*^}QX zG4-Nf>`7dCNo*BCt~kigt1>SjI96n(byT2HfA!^|4#vSwNaOj>n#L{}{Eb!Q-}%I@ zzG6pKV^#Q<+{>9=ZjkpjOL3DXEDE8=%-w4t9I?~6U9yEQ+U z@k7Vlex%!1sUmyv_)C&OSIIifj!SA98)?{VH8|p|$}6*kd9icg(M~5*@Lt7eA;rrW zHCjQ2(rHfvD#LXfDc#BP^>>c{vU_6D)vF_cLuh+2k5vET{19}0e$7*v_^z&3KC9h! z@N+NY1Jb$Z2{^Y-O33@c$LBVZ#@N>9_3kW}SqfsANl^b{){2V4!cFoHU}tlgJW(cU z5M;2O&*x?c`yK8V;rGAX%{;S@s%)=>-fMPp9A(6Wzw&Xqd}lNIhmVJ}fAw^(h9^rv zl*4}HUDxcD@E3lC0Yl`9gsZkA;e&qo^Y|rJlAbK)-h?*jp0M`?>#0>N^X;$Yp`+wX zVZR>uVp%r%5jQpCF130Pg`(+;r6#AUo_%`KOIw}f?0#3d3ih!?ve^2I=RL+=m$UpK zAZ%3EW5Iq&aRU197DBwM+;#Y_VZq~$$(8A!GPtQtkB7@`WEP^FZG>4tw+H5hovuoV z)&lJoL^kiH-i%xwJvrmpaGG4|8nC+_yt-{>x(>d_S)Kspzn9>4AH*BLHB;0ny*#=3 z(|ZQ4P5gYRL37F&C7yr4B22NIbvMquwapYCiGmQnj8C$=Om0irSgPT^jGrx~2`T+e z4?%z_AmfKcfmF6@pi6*Ra}4pM;dZQkaJ0p z)i(%ddod?+K~eRd@O)0P$G++Tfe)O5-&D!0?b|;`WUm56&lPHT63KUddV8@%cjn-O zq9AQ(53{%0XmwSS7eOK+%oMt+R4Eejbo5a{C+-qrSUR`fR zk5sff?hJSO-0}MgcwgHqD&im`bqqeoau$|LdaK>)Tyh>qX4hU*TrBOlla`hiOCtr` z=>BKDSOrY{cP*J75m#MB@~NBGleSG|GY99;@$fk;Z0rV|iZQtlHjB>Vf>-a5Cc!p>$qX$6t|h2uQGk*Y009N+jHV$UY7ldx<^A<(w$Ej%`>0h_$EWJ;5%w+ z!6zFKCE?7}R3@$Y<>kZW@ov`P5fxX(b^%)2?Exx36Mjq$IzQlfFxlHDYD_K<7nFo< zXlJ;eTbY`ffvWoL3j~mnC{EI>Dq8@fuBr=hyU`mWS1Gc8iz|Hpr;o_+EjxR%Uan!6 zui03J(fx*<-`&!|Od0S#&*kakKM!R;-kS}5Q`W1C)5Avctj8qT^CcxEHSoRp3Z>iF z*f{CDJASFDx1r@YDM2KNxZd)6yj#oEtXr^FzXP71W^(1~7FOkVHpEb8IvN*_G6Za- zq|4h<_m10xGB`d8QjVAVRwPepX=z6C?-Y)$RI@B}Y;2deBphFU0Sn=};xflqb$L2K z6%OKfBBB)XtvWpoB_mPBOA{_6p9Z--6 zF)=XseQx3G725{0E{$g6S!=*1M|^=4DHVNifu_Ae5}9iSR^_?eaodSdsk`z`QgX7U zfr0PdMDCJZ*NVsY{{DVA+!+PQlj2#>%5;fZ5dvN$9GWa8A)%uBMo6gB?-3DT*m1L) zesgn!h2;KavEBk11xvY8XvI7>HZ~$eGMe&X)$0VH4=cS4+1|CbEBvQtWmTP?z&>dj zcobY~0=r=E;=&EYD$diMFmOU>r2eD98$&UZ)CIgC+|ktkb%Ka^M{ z&!b~$$-I@wQrWyYDMj@a38^*Y<{Y}_bG34JdF0f#d%V(S*LKucl;s)rXdP z(`Y^mc#e5{0b?-e1d{mh&>Bhygz>hnUB^o*Dt0Y3@Z_?~oPJgN8OGz*LY*0V^UtlJ z&p=l7Y1f(ZvGche&KD}A18H2f?L>@(roP9Cf#eTM(zR9TtUZ6%h12GG^x|XS_V!Tx z-yCqyB6gh7(Bu%3R#bfTF%XLfMMGR1`EOBK=QBZj`2G2ve9AlO_wUt;utM zk3g*vy4?e-6)AEE{sNwa$8x%uT0B^J_m^p%_S+;}q3fT?2c}wD^FTTaI`2)y#KZuV z2uO$M`?=%g7RV7Swo*buLf>O2vAzU83Vi-<7f^#bA1;@ALvXzwMgvi>)81Re8B`T< z&3F0vbsAO5E6 z`%s3g7`<#Z;;@%?%^N7)j*IO5x`C*;zQA@q!we4(H}pEqGjeJnr;}>p*ntQ7k$JM&48J>pvUyM$TRDxw$8URX7ks4B6y@o(cOe_twwH z%@+sy`z4vltgNiu4(A;Z_a22I&HIJvd*r9M+GR63`uY_n?q)=un-#JzB|Hl!9CAXQ zQec#Jc%P5*z^m`}i?UM;o)wrY`G1=bE=HuKrluw&yf^(#d}?>(dIy9qkL_}^$GPd; zn$zJt2S!Flazb)4S)?Qpl?RX&Oct-Tr0Fni;y!OU0rhx57@<;aKba>nlFSZ$6tr6v z&@qDVO$NB^rMCLqT@FxsMU?JFe5qeZpiLF<;7oiT$D$k~gS+3;)1#37L4|jK@f8I{ zW^63S*Wm+vDou9NA?A*@yS0S+;IIM58(asFCq*p+oU zJYQpMG0-Gzba8ki`t?vj>NU@Y~a*uXd4f1ztD# z>gkcsgg(c#xO!N9{?NE&3l2XA3ULvpxZ`)A0U?ARZ9UOc~$To5DnA~+Q zai*#Mt*EF-DU&~u)Fd!4u#aUzL1CPIv2l5Md3ad1U#VE+RW#?t{rR{Y&WqzsnsK4K zw}Rh@lg;OLf2W==tsy?0J(w`-m)QImI|MqUp7#*YP(-OiKIeubkJt}1mX^xiOBwn- zT!4<7#j9h+m@>7ydw_NpTq=U4c{>TV>5m{Gd_ts7^(pV>UBM zI1#%kVG6Iq8=obh-HR4v>AfGc|4wi77>rF;tfzcEI-Mc;6;;EG>2*Rl3c8^6Y^AeTi}JMJ@3;j@S^7p<7rpP?5!W|(Bz!D`FJ7l=59h^i>)8rt_;E8MZd;43R~~!& zAF)r^Q46H z&k}{0v@BF?(qGrO&n+DN)a5zbT!4j~dMxw<9+Z&7xmYwbnM13jL;AK7} zj(QICpq$V0w#RQ;l}m&qm-JLrL|HM}7TJ6zbDyiQdoe!4c@`v;`z5U>OZa{R*HI-1 z>HGHt0`M!LeyV_g00C0u)|wiXcIC1e)qWgqlFF{UuKt9Q2Acx#@RXL z3?Tb(NsI&>79+jPafUPcgYC(2Flg3VOF?*zB zebX@(2HM3?JOhh%YL9VgRB}=hv;0=Ggu?vveW~|DVIlpgm}k2p&|cHdmoKApuKji9 zt2%Ej=gKZ7;zAm4aziNdCiI7f)yvv}9;ZOBCPhd}p^0}<8zLqmDzYcYyjW}#Xm_g` zCEE}DK00lfI9p|C^Nk!m{X#0>iTe_2Fxx$P?WUU1Ld$kmT$gN4+Rt&m5|WIo)VCWC zL?IsTd4S)wtQ%8?D9*3`YoCb zAGa^piVXBHN{Y^vXVOOLJ$I<;`#p;%V_@mH#az?ztWjsXp`jrl(TBf1K^C|r+z~7B zPt=J8UWYp~s_yK9u8ag373Y4g3(?0Y4uW~MLnw95Ch-4kdV+V)npQo-H@*9-_={g3 ze8v4P5@^5d1*~GJi4#%c*S@|!b#gUbqUXMTw~*{-3m%rwJuVl_z+kXX$!`_O?`aZ( zw}U{z7C!9(X0Lz~?qT~X3m>4Zq2f~J&w?Gc`iFLInaE}3U&xql?`Z=0^*5*K5HA}@WhsxGpktFCPFC8I-^lROC!`V*X2NN{ zlm8t&#{Cd9*N4W@g7hS*YMlv+Z@7oE1U%vvxr-FiB`uV?`4iONzJ2T59vsXj6crLN9#Ep4dV2&Zx2$7j6fm8sSZAcCk37ydxW%lw zNk#DzD1zR&tC{~7cZk4-jN zW;FsfSH+V)y0fz*-}EtBK(_Hm)BW#MF0v2SIq%njsrm&0f%s1EU!l@XlSm1J%~pV| zske|VH(Vwo4db?3z~o>sj3)CJAb!$hKesjvM3B%d^d*Pw6p)`*@jnK@!(o+eif0s) zx3{-|>z#S+Lb)+TfCea(VuKP2fqo1&7R+`)w(O~3JdRqR>O-2n;-%_8a$}AFC zkxK65O}akud-Q@;H1Y4+6$C^BMaWOL!?Pi0>kS=Gaj=vT^%m=`VoNgJwlt3D?hh2E zB!c&bf;Zdoz`noq3(CS%Hw|6WD=Pdr6fEz#`FHsKR5s(W(TgiA&ym<%###_zF2|^` z*BXo;fG_DW@9+eLNr|A9SJZs)ukGMmzUVHxe_Z@nCz|d1^;-@k!t)`K9il^cIe3X2; z8SX2M z^bZ1b?mDhkmlSk{K}UnUal~PgVqWqLUkvyw-T|brjt`{4u z=&0CMx`FD>Y>QH0egKU44()vR)FFxlnfRhjQ*9@m=}`hRJtS2V-MK-yThv3AC{)<0 zB@)~SKrAlQWUy5qEj6i$upkD3G3n1Q0wpxk(YEaXIOdS4t>-H}ml=(*QF36KEV3!2 zz%Q3k5)noTqENxRSXM*E>F65STgp;Ks6OEy3?))k{E3gvKVc(sp;$VLmUK6z{e9|_ zy2Z{X-_HMH0j2`9snpvY7qhyXM>jCTM_Gl4I9NFDv`LivC?FZu0a1<*=#S*-Jb2VL zeJEFUJ>BLE4waC1FE$UFDb4jkS=F8q(-@_44kPhxgqX8K$i+&VTR6?Lvqh^aKH+|M zcnD+PFK2Gc?c-d*lRgh&u~2PMVC<+ekdA7Sbdf5&%axPJP^DLI!5`P!d)1))L+S`z zRI(<8p>Yi8{Pb-WU1v3=Y$1JRntUmc#Clue#mRJhbq$ zO#7e1g}RcGl1(h+0t~7QLb#AJ04Ro8I`I))HG1#7%>@$s}BM& z+3Z1%C79Ej`+Yy?*-A;A`OqoB)4^l7<*yBH9)YQ=*hBvwTd-z3cUNF&Jw&JBnT%a< zTXo++45y3l;r0Ulf0{piyZ9cqZ>?yz7<0I0xfXSc&m&JX32gG=Gq=`QHHP z^&^>z&oPLUqHpB+9b+oLtHWm^c7sC!vM0TCl+fR)z0ORQ?qK&NkI-f{m6Wj;z+A%C7&aWz z+RA_GI3(#mHl5nWWjW1wDpp0nOHl#JHusd2ZWLB!6I;&s1s=eY;En6btA7c30F-nn z=t-(P{V=L*rBdWrf)4)M{MKfZHGw9^`xxtx3sMQ6%^^j1N8<=gjHxW$vwyX`@U8E> z%ovqi8;z|916#lCpM*8cJcCPRG%fd#39`6&Z9f1f#8ox?0g!~?saTlI@bEA(uF6vd zyw{Ti0hBQjO^n>kJopExTxJ*;7{5-am48ZNS4J6tr=#2f5ECk_=ufh9O6)N%a2~;% zES9^gz_S9Ml4Cy=4ogSB!CtEU8veVf){B-Bvfv>fRbBmVNOWHBw}TX`hk80uJB}>V z@Lxr?{{}!Lcvzg;8X7ZQevde$#fvA~2WD}!fqrv!Le8ASkg4wsJS;;%F2nkM3KNQl zh2(=Xs!bwAe;9mc&E&zh*IsR{YKIL4RKxUDj1 zWGqh*fKKt@Q)Z(#LhON~8AJ%ug}YJ6tD6?law1TXcT4w5ZfdQE`82@pb!-)9^Wz$ZR4S z0GVP6(PMJ2*z_1Ff6RcxbC=>WI+bp;&M6`{?T6h*Bm)03M7_m{@4z$?s&)nR@UxS> zr&)32{E4>x*km7?5$ixZvpW^De8~OuvJmFHd#vZs_cDM^K|x`qam3tBXcEAho8Jox z3O3*9h|~^6>)>_}ceR4id#JOnR|w4Fjz$bjlJ;))+$YndW{?c&TPmum+$O(`*q7*^ ziVcJKx)LTwWGRVgL&);M-PfT&1pegX?jYj~TE)Y4{An+)=dN>p`6bSC7!92h#qVas z@D~jpGu34>#?v`%SxX`y%H6|kpvoU>QJ+e9!h=kgbNk;p)Q<5jCS>G}4GQc+)DzlOMM0z?NU zHZ}#nGvf?$!n82|m$`NkGWnrDWtFY6XHC;*vM=8bRnAp@H8Tre!zqA&p6j${=Q}2E zkQut*w2y(kooIOQ1=+YU+OcQxe!S;QF;osc_~J_No#urblz{a{=;hbPWuK@U03*^S z10k>)O%e*g!d6~{tSMSPf6aEF-Sd#sAfk$-fEp9U3|`U5XaHV4->Lw-4%OP7Inl}& zVnn&d8PLks*AI8q;C2`g7)sP6g8RV^gqKdIbG?WH~8TTX?%uy~ZbzcGqSS}%DUhIw+ z>fHNr-;^f`p!YZDeh)Ci6~#LkdmL-PYHs7toss0bQ%n#^1Ddj}vMuE*1;{nOu+S49 zTh&E*SvxJO${^wnY8bZ>6i3|9*mw!>-fZ5nE8~$SB7Pe;+Pg$`b@g`?A{Cz=cX_&u zydl5@FNjZD)LQU9VQD;U;LrL^jWFc~%WVX%K-%0AwLTsRmvh~Jq4;5MKH-@tw2IWuI%KygJ@Sy|c0h`OQca@pK|DqkicIi{?mLbu6w zIDyIFW1z`uyT|5D&Ke-I*{Gs*&lalk*%T#GO?(T_TmF4m^ZvEDDJ=?oF=+YBYJlRaKh{TX9AhK!>LOPdOKmk4wp8JF@&rvb&HBan7MBJtMN{ZOf>J&iG+siquj!lqdIJ+*9|20b9@4u{e=^PF0Qe5FQEUp`M*v`FVPV0g6p)UD zL>c*hD%XllOzd+eOUU&BW_nr{8L4Q>0>Wd!eHwGO0%+5w)LRO`XMhUJYl6L`mb3ES zb#LC9p1jDc1F17n3H!Exrk?51Z?~A;X*~)}8WCU|Djkaax!gdMo3bqQ>eZ`O%4S`8 znRIr;(PqHynwpx*NbWix14U`G(Y9SOZC}=^Or0$`$x)WJ%XD4*^ldr9;^)6v^!L94tzxAo2U04qK{X%`geB*W_S4d}Z5(~EnTLbuhDsq@f- z$)51rpV#d+`LGQ9$LGV48!LIV_|PnkWVdM>{X%$jz<3mIpzlZOvhL6J?-$Mh^>q(o zFL>cBGZ;C@?|P_3hpZ*1C?r?(`D}YAPW<^TXMg6}iYKfBP~l+!F(Xs5P->}RN$~4( zr|!#^=MlLoygrWi4%d=*KJfS+mW zX=swysOXTDR~$_P-rSa)*8w18A0gQY+N-6%+Jl=r(Lv@|>uA0v@Z{&d;r;Pnt~#a= zM##V`Y~{`5zhdygvEezC!9`O)Mo8$e7=_#G()!fVay>jMDv8`m>fKNsm5Z|I^av%! z6HI-{4r&rb#`ar57vN=5Qi!`DJAhK3ueTuB!nLK!OV)D?HCY|vd!1lCb_gkoj!RK? zL?-X^Uv5JcihA;T!FBmW;PE z@R*%l51{=(fv*KtsAB*0^i)VPa2igtAaIYkJK zRcqxeBZCf!bXg)$AaNhsk;SlY!T+?aL)kVA@M+rQJKj%`zB2$OYG3_>X0M>baeDMpYq~FL)&c)s--sly_|sJWI@8Gubzt8NnbAfk^8P8 zaP&m5c(%%r-Ca(Zvu%^&))Xr9_-mWqJa7Hishwp^k{$yGN326APMXPp=Rk_4`h>I) zLjOuK$K5!MP->Ef&mzAEtf++!>gt$%3&3Pz<8v?HerqJa zzH7dZ21oJ&QtcO+5;R=rI6f}Un+pE7v}`s7l!R_?MGKp@`U9N!wCB$s`=+ZgKGLrhkGp%o!NB*8Bx$>C}8?X>tA`qASe$P5jma@$gZvQQ{Ys3}gt)Og@|Cysc56ZdT>x*S;iE(LIO({eO$PFPKHB&< zKdkxxu{@pM$N+)N*OnQb2L@NQ?24&XpngQ?}^ zw|hd1YJ-A^ojj)2mewKZe4wo)lHa(_lxj@NZzZc&Y;!H0(kms$FTZFF*N4Y$spPO2 zNLz$d9$_q@w~3EF+a!F#UF@>NwC}NU^HJ{Ax^aJm0|miUzg%aNJa(ERNede---)4~ zo}Lt(K^}lL?ZXY`lW+R{*jo4Ah^iHSGYP@R2nEKJ<%@?buVWb*nb62c3O>jD=DE~nr^0oc zH<`qeKl`QG zQ;=-HZ0_I=&}@El%DO1}tKnw7z&FCdr75saW+%a(DWqp+dS-Wvf*`)UgL3J{|5is8rq)4OQXJJ;&0oa{r=FNQVoQpaU?X zhIU9uNZ5ofLWJ){9q}6O@4XA}Vy)c@Eqf{4mZ`7sEkOo?Qpu&T@BOvmwwdE1@r%60hTC&R6N%6ueAmSnwpu$V((rG&e4Jhd;n*BO!#slPRg;_g c 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 literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/neural-networks/all/index.html b/apps/website/public/ru/learn/neural-networks/all/index.html new file mode 100644 index 0000000000..06ba8b272b --- /dev/null +++ b/apps/website/public/ru/learn/neural-networks/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Нейросети на t27: от одного нейрона до блока трансформера: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

Нейросети на t27: от одного нейрона до блока трансформера

+

Агенты этого проекта думают нейросетями, а здесь их части записаны спеками t27 с тестами, которые проверяет компилятор. Каждый виджет исполняет тела fn спеки из specs/ml, скомпилированные в WebAssembly: двигаете ползунок — отвечает спека.

+

Курс 10, 27 уроков, в каждом живой виджет и спека t27: функции активации, softmax и эмбеддинги, пулинг и пакетная нормализация, функции потерь, SGD, RMSProp и Adam, обратное распространение и XOR, рекуррентные ячейки, внимание, блок трансформера и PPO. Каждое число вычисляет скомпилированная спека.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

0 из 27 пройдено

+

Открыть интерактивный курс →

+
+

Модуль 1 · Один нейрон

Нейрон складывает входы и изгибает сумму: ReLU, сигмоида и tanh, и где каждая перестаёт пропускать градиент назад.

+
+
01

Урок 1 из 27

ReLU: оставить положительную часть

+
+

Вы узнаетеЧто ReLU делает с положительным и с отрицательным входом и почему наклон 0 останавливает обучение нейрона.

Нейрон складывает взвешенные входы и пропускает сумму через функцию активации. ReLU из них самая простая, max(0, x): положительная сумма проходит без изменений, отрицательная становится 0. Её наклон равен 1 или 0, а наклон 0 означает нейрон, который перестал учиться: градиент через него назад не течёт. Утечка это исправляет: с наклоном 0.1 вход x = -2 даёт -0.2 и пропускает назад градиент 0.1. Спека relu_activation.t27 вычисляет обе кривые, которые рисует виджет.

Попробовать

Поставьте x на -2 и прочитайте наклон с утечкой и без неё; затем найдите наклон при x = 1.5.

+
ReLU: what a neuron does with a negative numberВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/activation/relu_activation.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Сигмоида: число в вероятность

+
+

Вы узнаетеКак сигмоида переводит любой вход в вероятность и почему её наклон мешает глубоким сетям.

Сигмоида 1 / (1 + e^-x) сжимает всю числовую прямую в отрезок от 0 до 1, поэтому её читают как вероятность: 2 превращается в 0.8808, а -4 в 0.018. Её наклон равен s (1 - s) и считается по самому выходу s; он наибольший в 0, где равен 0.25, а при x = 8 равен 0.000335. Градиент, который идёт назад через стопку сигмоид, на каждой умножается не больше чем на 0.25, поэтому глубокие сети на сигмоидах учились медленно. Спека sigmoid_activation.t27 вычисляет кривую и наклон.

Попробовать

Найдите вход, при котором вероятность равна 0.5; затем перетащите к 6 и посмотрите, как мало осталось наклона.

+
Sigmoid: turn any number into a probabilityВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/activation/sigmoid_activation.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

tanh и насыщение

+
+

Вы узнаетеПочему tanh центрирована на нуле и где её наклон падает так низко, что нейрон перестаёт учиться.

tanh это сигмоида, растянутая на -1..1 и центрированная на 0, поэтому слой нейронов tanh передаёт дальше значения со средним около нуля, а её наклон в центре достигает 1. Она тоже насыщается: при 2.5 выход 0.9866, а наклон всего 0.0266. Красная полоса отмечает все входы, где наклон меньше 0.1, дальше примерно 1.8 в обе стороны, и нейрон, чьи входы живут там, почти не учится. Спека tanh_activation.t27 вычисляет кривую, наклон и свой пакет, tanh от 0, 1 и 2: 0, 0.762 и 0.964.

Попробовать

Тяните x, пока не начнётся полоса, и прочитайте наклон там; затем сравните наклон в 0 и при 2.5.

+
tanh: where a neuron stops learningВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/activation/tanh_activation.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Новые изгибы

Гладкие кривые нынешних моделей: GELU с провалом, Swish с ручкой и ELU с полом вместо обрыва.

+
+
04

Урок 4 из 27

GELU: провал ниже нуля

+
+

Вы узнаетеЧто вычисляет GELU, почему она проваливается ниже нуля и насколько близко подходит её приближение через tanh.

GELU взвешивает x вероятностью того, что стандартная нормальная величина меньше него: GELU(x) = x Phi(x). Большой положительный вход проходит, большой отрицательный исчезает, а между ними кривая проваливается примерно до -0.17 около x = -0.75 и только потом растёт. BERT и GPT используют её в своих слоях прямого распространения. Точной форме нужна erf, и спека вычисляет её приближением Абрамовица-Стиган с точностью 1.5e-7, а также вычисляет приближение через tanh: при -0.75 они дают -0.16997 и -0.17004. Спека gelu_activation.t27 вычисляет обе кривые и их наклоны.

Попробовать

Найдите нижнюю точку кривой по её наклону; затем сравните точную форму и форму через tanh при -3.

+
GELU: why transformers bend a little below zeroВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/activation/gelu_activation.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Swish и SiLU

+
+

Вы узнаетеКак x, умноженный на sigmoid(beta x), открывает сам себя и как один параметр переводит его от гладкой кривой к ReLU.

Swish это x, умноженный на sigmoid(beta x): нейрон, который сам себе вентиль. При beta 1 он называется SiLU, и его нижняя точка -0.2785 около x = -1.28. Увеличьте beta, и вентиль становится резче: при beta 8 кривая это ReLU со скруглёнными углами, при beta 0.5 пологий склон через ноль. Один параметр переводит нейрон от гладкой кривой к переключателю, и сеть может его выучить. Спека silu_swish_activation.t27 вычисляет кривую и её наклон при любом beta, а также свой пакет при -2, 0 и 2: -0.238, 0 и 1.762.

Попробовать

Держите x на -1.28 и поднимайте beta от 1 до 8; затем найдите beta, при котором провал на этом масштабе исчезает.

+
Swish: one knob between a smooth curve and ReLUВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/activation/silu_swish_activation.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

ELU: пол, а не обрыв

+
+

Вы узнаетеКак ELU сохраняет мягкую отрицательную сторону с полом на -alpha и почему её наклон никогда не умирает до конца.

ELU сохраняет положительную сторону ReLU и заменяет обрыв на отрицательной стороне кривой alpha (e^x - 1), которая выполаживается к -alpha. При alpha 1 вход x = -3 даёт -0.9502, уже близко к полу -1, а наклон там 0.0498: мал, но не 0, так что нейрон ещё может сдвинуться. Отрицательные выходы не выбрасываются, поэтому среднее выходов слоя ближе к 0. Спека elu_activation.t27 вычисляет кривую, наклон и пол, а также свой пакет при -1, 0 и 2: -0.632, 0 и 2.

Попробовать

Поставьте alpha на 0.5 и прочитайте пол; затем найдите, как далеко влево должен уйти x, чтобы наклон стал меньше 0.01.

+
ELU: a negative side with a floorВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/activation/elu_activation.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Слой

Что окружает нейроны: softmax превращает оценки в выбор, эмбеддинг превращает слово в числа, dropout выключает нейроны.

+
+
07

Урок 7 из 27

Softmax и температура

+
+

Вы узнаетеКак softmax превращает оценки в вероятности с суммой один и что с ними делает температура.

Классификатор заканчивается одной оценкой на класс, и softmax превращает оценки в вероятности: exp каждой оценки, делённая на сумму всех. Оценки 1, 2 и 3 становятся 0.090, 0.245 и 0.665. Если сначала разделить оценки на температуру, меняется уверенность: при 0.5 верхняя оценка забирает 0.867, при 5 все три равны 0.27, 0.33 и 0.40. Языковая модель выбирает следующий токен именно отсюда, и настройка температуры чат-модели это и есть T. Спека softmax.t27 сначала вычитает наибольшую оценку, поэтому exp никогда не переполняется.

Попробовать

Охладите температуру до 0.1 и прочитайте три вероятности; затем сделайте ничью и нагрейте её.

+
Softmax: how a network turns scores into a choiceВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/activation/softmax.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Эмбеддинги

+
+

Вы узнаетеКак токен превращается в строку чисел и почему обучение меняет только прочитанные строки.

Сеть не умеет умножать слово, поэтому каждый токен это индекс в таблице с одной строкой чисел на токен, а поиск токена копирует его строку. В спеке в таблице 4 токена шириной 2, и строка v хранит (10 v, 10 v + 1), так что токен 2 читает (20, 21). Обучение отправляет градиент назад только в прочитанные строки, а токен, прочитанный дважды, собирает оба: строки градиента (1, 2) и (3, 4) на токене 2 складываются в (4, 6). Спека embedding_layer.t27 вычисляет поиск и градиент.

Попробовать

Прочитайте токен 2 дважды, а затем токены 1 и 3; каждый раз сосчитайте строки, где градиент не 0.

+
Embeddings: how a word becomes a row of numbersВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/layers/embedding_layer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Dropout: выключенные нейроны

+
+

Вы узнаетеПочему выключение нейронов во время обучения помогает и почему выживших нужно масштабировать.

Во время обучения dropout случайно выключает долю p нейронов, чтобы остальные не опирались ни на один из них. Выжившие нейроны тогда нужно масштабировать, иначе следующий слой видел бы сигнал другого размера при обучении, чем при выводе. Обратный dropout умножает их на 1 / (1 - p) при обучении: с p = 0.5 вход 1, 2, 3, 4 становится 2, 0, 6, 0, а вывод это простой проход. Классический dropout оставляет 1, 0, 3, 0 и умножает на 0.5 уже при выводе. Спека dropout_layer.t27 использует фиксированную маску, оставить, выбросить, оставить, выбросить, поэтому числа каждый раз одинаковые.

Попробовать

Сравните выходы четырёх режимов; затем прочитайте градиент выброшенного нейрона при обучении.

+
Dropout: training a network with neurons switched offВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/layers/dropout_layer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Картинки

Чтение картинки по участкам: окно, усреднённое по участку, max pooling и пакетная нормализация признаков разного масштаба.

+
+
10

Урок 10 из 27

Участки картинки

+
+

Вы узнаетеПочему сети читают картинку по участкам и что даёт окно 2 x 2, усреднённое по каждому участку.

Картинка это сетка чисел, и сети читают её небольшими участками, чтобы один и тот же детектор работал в любом её месте. Здесь окно 2 x 2 шагает по 2 по картинке 4 x 4, где в клетке i лежит i, и каждый выход это среднее своего участка: 2.5, 4.5, 10.5 и 12.5. При обратном проходе градиент каждого выхода делится поровну на его 4 клетки. Это усредняющий пулинг: свёртка взвешивала бы 4 клетки выученным ядром, и её спека, t27#10612, ещё не слита. Спека avgpool2d_layer.t27 вычисляет оба прохода.

Попробовать

Нажмите на каждый участок и проверьте его среднее на глаз; затем включите градиент и прочитайте, что получает каждая клетка окна 4.

+
Patches of a picture: a 2 x 2 window, averagedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/layers/avgpool2d_layer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Max pooling: максимум окна

+
+

Вы узнаетеЧто оставляет max pooling, откуда, как он помнит, это взято и куда идёт градиент.

Max pooling оставляет наибольшее значение каждого окна и отбрасывает остальные, поэтому сети становится менее важно, где именно лежит признак. На сетке спеки 4 x 4 окна 2 x 2 с шагом 2 оставляют 4, 8, 9 и -2, взятые из клеток 5, 6, 13 и 11. Перекрывающиеся окна 3 x 3 с шагом 1 оставляют 8, 8, 9 и 9. При обратном проходе весь градиент окна идёт в его максимум: градиенты 1, 2, 3 и 4 попадают в клетки 5, 6, 13 и 11, а все остальные клетки получают 0. Спека maxpool2d_layer.t27 вычисляет выходы, их позиции и градиент.

Попробовать

Переключитесь на окна 3 x 3 и найдите клетку, общую для двух выходов; затем включите градиент для окон 2 x 2.

+
Max pooling: what a network keeps when it shrinks a pictureВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/layers/maxpool2d_layer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Пакетная нормализация

+
+

Вы узнаетеКак пакетная нормализация приводит признаки разного масштаба к одному и чем она пользуется при выводе.

Признаки разного масштаба дёргают сеть: в пакете спеки один признак в десять раз больше другого. Пакетная нормализация вычитает среднее каждого признака по пакету и делит на его разброс, поэтому признаки 1, 2, 3, 4 и 10, 20, 30, 40 оба выходят как -1.34, -0.45, 0.45 и 1.34, а -1, -1, 1, 1 выходит как -1 и 1. Затем выученные gamma и beta масштабируют и сдвигают его обратно, где это полезно. При выводе слой вместо пакета использует скользящие средние: при среднем 0, дисперсии 1, gamma 1 и beta 0.25 входы 1, 2 и 3 дают 1.25, 2.25 и 3.25. Спека batchnorm_layer.t27 вычисляет оба режима.

Попробовать

Сравните два нормализованных столбца; затем поставьте скользящее среднее 2 и дисперсию 4 и прочитайте выходы вывода.

+
Batch norm: features on very different scales, made comparableВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/layers/batchnorm_layer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Ошибка

Насколько неверна догадка, одним числом: среднеквадратичная ошибка, перекрёстная энтропия для вероятностей и функция Хьюбера для выбросов.

+
+
13

Урок 13 из 27

Среднеквадратичная ошибка

+
+

Вы узнаетеКак MSE превращает каждый промах в одно число, почему она гоняется за большими ошибками и куда смотрит её градиент.

Функция потерь превращает все промахи модели в одно число, которое нужно уменьшать. Среднеквадратичная ошибка усредняет квадраты промахов: предсказания 1.5, 2 и 2 против целей 1, 2 и 3 стоят (0.25 + 0 + 1) / 3 = 0.4167. Из-за квадрата промах на 2 стоит в 4 раза больше промаха на 1, поэтому MSE гоняется за большими ошибками. Её градиент для каждого предсказания равен 2 (p - t) / n, здесь 0.333, 0 и -0.667: каждое предсказание толкается обратно к своей цели. Как функция одного предсказания потеря это парабола, чаша с одним дном. Спека mse_loss.t27 вычисляет потерю и градиент.

Попробовать

Передвиньте предсказание 2 на его цель и прочитайте потерю; затем ведите по чаше и найдите её дно.

+
Mean squared error: how wrong a guess is, as one numberВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/loss/mse_loss.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Перекрёстная энтропия

+
+

Вы узнаетеПочему перекрёстная энтропия так дорого берёт за уверенный неверный ответ и почему именно это учит классификатор.

Классификатор выдаёт вероятность, а перекрёстная энтропия берёт -log вероятности, которую он дал верному ответу. Предсказания 0.8, 0.3 и 0.9 против ответов 1, 0 и 1 стоят в среднем 0.2284. Быть уверенным и правым почти бесплатно: 0.99, 0.01 и 0.99 стоят 0.0101. Быть уверенным и неправым дорого: 0.01, 0.99 и 0.01 стоят 4.6052, а к 0 стоимость растёт без предела, поэтому спека обрезает p до [1e-7, 1 - 1e-7]. Её градиент наибольший как раз там, где модель уверена и неправа. Спека binary_crossentropy_loss.t27 вычисляет потерю и градиент, из вероятностей или из логитов.

Попробовать

Тяните предсказание 0 к 0.01 и смотрите на кривую; затем прочитайте столбики градиента при 0.5, 0.5 и 0.5.

+
Cross-entropy: why a confident wrong answer costs so muchВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/loss/binary_crossentropy_loss.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Функция Хьюбера

+
+

Вы узнаетеКак функция Хьюбера обходится с малой ошибкой как с квадратичной, а с большой линейно, чтобы выбросы тянули слабее.

Квадратичная ошибка позволяет одному выбросу всё решать: ошибка 3 стоит 4.5 как половина своего квадрата, столько же, сколько 36 ошибок по 0.5. Функция Хьюбера равна половине квадрата, пока |e| не больше delta, а дальше растёт только линейно, delta |e| - delta^2 / 2, так что при delta 1 та же ошибка стоит 2.5. Два куска сходятся с одинаковым значением и наклоном, и градиент никогда не превышает delta: далёкая точка тянет модель с ограниченной силой. Для пары ошибок спеки 0.5 и 3 среднее равно 1.3125 против 2.3125 для половины квадрата. Спека huber_loss.t27 вычисляет обе.

Попробовать

Поставьте delta на 0.5 и тяните ошибку к 3; затем найдите, где две кривые расходятся.

+
Huber loss: a loss that does not panic at an outlierВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/loss/huber_loss.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Под гору

Спуск по функции потерь: градиентный спуск с моментом, RMSProp без оглядки на величину градиента и Adam, который соединяет оба.

+
+
16

Урок 16 из 27

Градиентный спуск

+
+

Вы узнаетеКак градиентный спуск идёт вниз по функции потерь, что добавляет момент и почему слишком большой шаг никогда не успокаивается.

Обучение это спуск под гору по функции потерь. Градиентный спуск каждый шаг сдвигает вес на -lr, умноженное на его градиент; в спеке потеря равна (x - 3)^2 от x = 0, и lr 0.1 доходит до 2.99996 за 50 шагов. Момент добавляет долю прошлого сдвига, что ускоряет длинный склон и перелетает острое дно: при 0.9 вес пролетает 3 примерно до 5.13 и, раскачиваясь, приходит к 3.09 после 50 шагов. Нестеров берёт градиент на шаг вперёд и качается меньше, примерно до 4.25. Слишком большой шаг никогда не успокаивается: при lr 1 вес навсегда скачет между 0 и 6. Спека sgd.t27 вычисляет каждый шаг.

Попробовать

Найдите наибольший шаг обучения, который ещё успокаивается без момента; затем добавьте момент 0.9 и сосчитайте качания.

+
Gradient descent: how a network walks downhillВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/optimizer/sgd.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

RMSProp: шаг без масштаба

+
+

Вы узнаетеКак RMSProp делит каждый шаг на скользящий корень среднего квадрата, чтобы шаг больше не зависел от величины градиента.

Правильный размер шага зависит от величины градиента, а разные веса видят градиенты, отличающиеся в миллион раз. RMSProp хранит скользящее среднее квадрата градиента, кэш, и делит каждый шаг на его корень, поэтому у шага нет единиц: при постоянном градиенте 0.001, 0.5 или 1000 вес на шаге 1 сдвигается ровно на те же 0.0316 и идёт тем же путём, доходя до -0.0914 после 100 шагов при lr 0.01. Затухание задаёт, как медленно наполняется кэш: при 0.99 те же 100 шагов заканчиваются на -1.0261. Спека rmsprop.t27 вычисляет вес и кэш.

Попробовать

Переключайтесь между тремя градиентами и убедитесь, что линии не двигаются; затем поднимите затухание до 0.99.

+
RMSProp: a step that does not care how big the gradient isВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/optimizer/rmsprop.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Adam: момент и масштаб

+
+

Вы узнаетеКак Adam соединяет момент со скользящим масштабом и почему поправка смещения делает шаг 1 фиксированного размера.

Adam соединяет обе идеи: m, скользящее среднее градиента, как в моменте, и v, скользящее среднее его квадрата, как в RMSProp; шаг равен lr m / sqrt(v). Оба начинают с 0 и поначалу слишком малы, поэтому Adam делит их на 1 - beta^t, и на шаге 1 это делает сдвиг ровно lr, умноженным на знак градиента: градиенты 2, -40 и 0.5 сдвигают свои веса на одинаковые 0.001. На чаше спеки (x - 3)^2 при lr 0.1 Adam поднимается от 0, перелетает примерно до 3.18 и успокаивается на 3.00005 к шагу 200. Спека adam.t27 вычисляет каждый шаг.

Попробовать

Дайте трём градиентам очень разные размеры и прочитайте веса после шага 1; затем найдите, где путь достигает вершины.

+
Adam: the optimizer most networks are trained withВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/optimizer/adam.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Обучение

Откуда берутся градиенты и чего они добиваются: обратное распространение через слой, сеть, которая учит XOR, и LAMB для больших пакетов.

+
+
19

Урок 19 из 27

Обратное распространение

+
+

Вы узнаетеКак градиент каждого веса и каждого входа слоя следует из градиента его выходов.

Чтобы учиться, каждому весу нужно знать, как меняется потеря, когда он сдвигается. Обратное распространение отвечает по одному слою за раз: при данном g, насколько потеря хочет сдвинуть каждый выход, вес от входа i к выходу o получает g_o x_i, а вход i получает сумму по o от W[o][i] g_o и передаёт её слою ниже. При входах (1, 2, 3) и g = (1, 0.5) градиенты весов равны 1, 2, 3 и 0.5, 1, 1.5, а градиенты входов 0.5, 2 и 3.5. Слой линейный, поэтому сдвиг x0 на 1 сдвигает потерю g . y с 15.25 до 15.75, на его градиент 0.5. Спека dense_layer.t27 вычисляет все три.

Попробовать

Поставьте g = (1, 0) и посмотрите, какие рёбра гаснут; затем поставьте g = (-2, 1) и проверьте градиенты входов вручную.

+
Backpropagation: how blame flows back through a layerВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/layers/dense_layer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Учим XOR

+
+

Вы узнаетеПочему один нейрон не может выучить XOR и как это делает скрытый слой, обученный обратным распространением.

XOR равен 1, когда ровно один из двух входов равен 1. Никакая прямая не отделяет случаи, дающие 1, от дающих 0, поэтому один нейрон выучить его не может. Скрытый слой изгибает пространство: спека обучает сеть 2-8-1 из ReLU обратным распространением, lr 0.05, из фиксированных начальных весов. Её потеря падает с 0.8896 в эпохе 1 до 1.8e-13 после 2000 эпох, а четыре ответа выходят в пределах 4e-7 от 0, 1, 1 и 0. Виджет проводит это обучение в вашем браузере, заново для каждой точки кривой. Спека mlp.t27 хранит сеть и тест, что она учится.

Попробовать

Отведите эпохи назад к 100 и прочитайте четыре ответа; затем найдите эпоху, где кривая перестаёт падать.

+
XOR: a network learns what one neuron cannotВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/pathway/mlp.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

LAMB и большие пакеты

+
+

Вы узнаетеКак LAMB масштабирует шаг каждого слоя его собственной нормой весов, чтобы один шаг обучения подходил слоям любого размера.

Обучение на очень больших пакетах требует большого шага обучения, а один шаг может быть слишком большим для малого слоя и слишком малым для большого. LAMB берёт обновление в духе Adam для каждого слоя и перемасштабирует его коэффициентом доверия, нормой весов слоя, ограниченной 10, делённой на норму обновления, поэтому каждый слой сдвигается на одну и ту же долю самого себя. В спеке веса (1, 2), умноженные на масштаб, делают шаг с нормой, в 0.001 раз меньшей их собственной: 0.00447 при масштабе 2, а когда норма весов переходит 10, около масштаба 4.47, шаг остаётся на 0.01. Спека lamb.t27 вычисляет обновление для одного слоя и для двух сразу.

Попробовать

Прочитайте шаг при масштабах 1 и 2 и сравните; затем перетащите за изгиб и объясните, почему линия становится плоской.

+
LAMB: one learning rate for layers of every sizeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/optimizer/lamb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Память и внимание

Сети, которые читают последовательность: рекуррентная ячейка и её затухающее эхо, вентили LSTM и внимание ко всем позициям сразу.

+
+
22

Урок 22 из 27

Рекуррентная ячейка

+
+

Вы узнаетеКак рекуррентная ячейка переносит состояние от шага к шагу и почему эта память затухает.

Предложение приходит по одному слову, и рекуррентная ячейка переносит состояние h от шага к шагу: h' = tanh(W_x x + W_h h + b). В крошечной ячейке спеки W_x равен 1, а W_h 0.5, поэтому один импульс даёт 0.7616, 0.3634 и 0.1797: память о нём примерно вдвое слабеет каждый шаг. Второй импульс на шаге 3 поднимает h до 0.7968, чуть выше, чем начинался одиночный импульс, потому что старая память ещё там. После 8 шагов остаётся лишь 0.0466. Это затухание и есть причина, по которой простые ячейки забывают длинный контекст. Спека rnn_cell.t27 вычисляет каждый шаг.

Попробовать

Загрузите один импульс и прочитайте, за сколько шагов он падает ниже 0.1; затем сделайте вход чередующимся.

+
Recurrent cells: how a network remembers a moment agoВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/recurrent/rnn_cell.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Вентили LSTM

+
+

Вы узнаетеКак вентили забывания, входа и выхода LSTM решают, что ячейка хранит, записывает и показывает.

Ячейка LSTM хранит отдельную память c и три вентиля, каждый это сигмоида между 0 и 1: забывание масштабирует старую память, вход впускает новое содержимое g, а выход решает, сколько памяти показать. c' = f c + i g и h' = o tanh(c'). В фикстуре спеки каждый вес равен 0, поэтому каждый вентиль это сигмоида своего смещения: при вентиле забывания 0.9975 и вентиле входа 0.0025 память 1 выходит как 0.9975, а выход равен 0.7587. Так как c проходит лишь с умножением на f, её градиент тоже переживает много шагов. Спека lstm_single.t27 вычисляет ячейку.

Попробовать

Загрузите Remember, а затем Forget и сравните новую память; затем запишите с открытым вентилем входа.

+
LSTM gates: how a cell decides what to keepВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/recurrent/lstm_single.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Внимание

+
+

Вы узнаетеКак внимание сравнивает каждый запрос с каждым ключом, что даёт softmax по каждой строке и что убирает причинная маска.

Внимание позволяет каждой позиции решить, какие другие позиции читать. Каждый запрос сравнивается с каждым ключом, q . k / sqrt(d), и softmax превращает каждую строку оценок в веса с суммой 1; выход это значения, усреднённые этими весами. Две головы делают это на двух половинах вектора. С причинной маской позиция не может читать будущее: в голове 0 позиция 0 читает только себя, позиция 1 делит 0.452 и 0.548, а позиция 2 распределяет 0.230, 0.321 и 0.449. Без маски каждая строка распределяется по всем трём ключам, от 0.21 до 0.47. Спека attention_mechanism.t27 вычисляет каждый вес на своей фикстуре.

Попробовать

Выключите и включите маску и прочитайте строку 0; затем сравните две головы в строке 2.

+
Attention: how a word decides which other words to readВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/recurrent/attention_mechanism.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · Трансформер и награда

Части трансформера и агента: позиции как часы, один блок энкодера и PPO, который учится на награде без рывков.

+
+
25

Урок 25 из 27

Позиционное кодирование

+
+

Вы узнаетеКак синусы и косинусы убывающих частот дают каждой позиции свой вектор и почему сдвиг это поворот.

Внимание видит свой вход как множество, поэтому порядок слов нужно к ним добавить. Синусоидальное кодирование даёт каждой позиции d чисел: sin и cos позиции, умноженной на частоту, которая от пары к паре падает в 10000^(2/d) раз. При d = 8 четыре пары поворачиваются на 1, 0.1, 0.01 и 0.001 радиана за позицию, как стрелки четырёх часов: позиция 5 читает -0.959, 0.284 в быстрой паре и 0.005, 1.000 в медленной. Длина каждой пары равна 1, и сдвиг на k позиций поворачивает каждую пару на свой постоянный угол. Спека positional_encoding.t27 вычисляет каждое значение.

Попробовать

Шагните с позиции 0 на 1 и посмотрите, какие часы двигаются; затем перейдите на 37 и найдите пару, которая всё ещё смотрит вверх.

+
Positional encoding: how a transformer knows word orderВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/transformer/positional_encoding.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Блок энкодера

+
+

Вы узнаетеЧто один блок энкодера трансформера делает со своим входом и что меняет перенос нормализаций вперёд.

Слой трансформера это два подслоя, каждый обёрнут остаточным сложением и нормализацией слоя: самовнимание смешивает позиции, затем сеть прямого распространения ширины 8 работает с каждой позицией отдельно. В порядке post-norm из исходной статьи блок кончается нормализацией, поэтому у каждой строки выхода среднее 0 и дисперсия 1.000. Pre-norm ставит нормализации перед каждым подслоем и кончается остаточным сложением, поэтому его строки выходят с дисперсиями 2.73, 3.33 и 0.96; глубокие стопки так учатся легче, с одной нормализацией в самом верху. Спека encoder_block.t27 прогоняет один блок на 3 позициях, d_model 4 и 2 головах.

Попробовать

Переключайтесь между post-norm и pre-norm и читайте дисперсии строк; затем найдите позицию, которую голова 1 читает больше всего.

+
An encoder block: what one transformer layer doesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/transformer/encoder_block.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

PPO и награда

+
+

Вы узнаетеКак PPO превращает награду в обновление политики и как его обрезка не даёт одному обновлению зайти слишком далеко.

Агент учится на награде, делая хорошие действия вероятнее. PPO измеряет изменение политики отношением r новой вероятности действия к старой и умножает его на преимущество A, насколько действие превзошло ожидание. Затем он обрезает: когда r ушло больше чем на eps в ту сторону, за которую награждает A, цель становится плоской. При r = 1.5, A = 1 и eps 0.2 сырое r A равно 1.5, но PPO засчитывает 1.2, так что один пакет не может далеко сдвинуть политику. На пакете спеки, отношения 1, 1.1 и 0.9 с преимуществами 2, 1.5 и 3, потеря политики равна -2.1167. Спека ppo_clip_loss.t27 её вычисляет.

Попробовать

Сделайте преимущество отрицательным и найдите, где кривая теперь становится плоской; затем расширьте eps до 0.5.

+
PPO: how an agent learns from reward without lurchingВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ml/rl/ppo_clip_loss.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Один нейрон
    1. 01 ReLU: оставить положительную часть
    2. 02 Сигмоида: число в вероятность
    3. 03 tanh и насыщение
  2. 02 · Новые изгибы
    1. 04 GELU: провал ниже нуля
    2. 05 Swish и SiLU
    3. 06 ELU: пол, а не обрыв
  3. 03 · Слой
    1. 07 Softmax и температура
    2. 08 Эмбеддинги
    3. 09 Dropout: выключенные нейроны
  4. 04 · Картинки
    1. 10 Участки картинки
    2. 11 Max pooling: максимум окна
    3. 12 Пакетная нормализация
  5. 05 · Ошибка
    1. 13 Среднеквадратичная ошибка
    2. 14 Перекрёстная энтропия
    3. 15 Функция Хьюбера
  6. 06 · Под гору
    1. 16 Градиентный спуск
    2. 17 RMSProp: шаг без масштаба
    3. 18 Adam: момент и масштаб
  7. 07 · Обучение
    1. 19 Обратное распространение
    2. 20 Учим XOR
    3. 21 LAMB и большие пакеты
  8. 08 · Память и внимание
    1. 22 Рекуррентная ячейка
    2. 23 Вентили LSTM
    3. 24 Внимание
  9. 09 · Трансформер и награда
    1. 25 Позиционное кодирование
    2. 26 Блок энкодера
    3. 27 PPO и награда
+ + + + + diff --git a/apps/website/public/ru/learn/neural-networks/index.html b/apps/website/public/ru/learn/neural-networks/index.html index 52c0e9fd4d..1e3d9d1314 100644 --- a/apps/website/public/ru/learn/neural-networks/index.html +++ b/apps/website/public/ru/learn/neural-networks/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

Нейросети на t27: от одного нейрона до блока трансформера

Агенты этого проекта думают нейросетями, а здесь их части записаны спеками t27 с тестами, которые проверяет компилятор. Каждый виджет исполняет тела fn спеки из specs/ml, скомпилированные в WebAssembly: двигаете ползунок — отвечает спека.

Курс 10, 27 уроков, в каждом живой виджет и спека t27: функции активации, softmax и эмбеддинги, пулинг и пакетная нормализация, функции потерь, SGD, RMSProp и Adam, обратное распространение и XOR, рекуррентные ячейки, внимание, блок трансформера и PPO. Каждое число вычисляет скомпилированная спека.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/no-credit-for-keys/index.html b/apps/website/public/ru/learn/no-credit-for-keys/index.html index 7a5d65019d..bcf55a4e97 100644 --- a/apps/website/public/ru/learn/no-credit-for-keys/index.html +++ b/apps/website/public/ru/learn/no-credit-for-keys/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Ключи не дают заслуг

Вы узнаете

Что приносят ключи, которые одолжил участник, и какие пределы их берегут.

Любой может одолжить улью ключи моделей через queen-contributor-keys.t27. Ключ проверяют, прежде чем включить: не больше 4 проверок сразу, новая проверка ждёт 60 с после прошлой, а у одного владельца не больше 100 ключей. Сам по себе ключ ничего не приносит: CREDIT_WALLET ложно, поэтому wallet_credit отвечает 0 при любом числе ключей. Опыт следует за работой, которую записывает Королева.

Попробовать

Протяните число ключей от 0 до 100 и посмотрите на счётчик заслуг; затем найдите секунду, когда можно начать проверку.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Lending a key earns no credit: XP follows recorded work
Lending a key earns no credit: XP follows recorded work ↗

A contributor lends the hive model keys. Drag the keys added: the wallet credit meter stays at 0, a key slot opens up to 100, and a probe waits out its 60 s.

specs/automation/queen-contributor-keys.t27

// SPDX-License-Identifier: Apache-2.0
@@ -251,6 +283,7 @@ 

Ключи не дают заслуг

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/one-edge-one-world/index.html b/apps/website/public/ru/learn/one-edge-one-world/index.html index 377ac72f87..53ef8a92e1 100644 --- a/apps/website/public/ru/learn/one-edge-one-world/index.html +++ b/apps/website/public/ru/learn/one-edge-one-world/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Один фронт, один мир

Вы узнаете

Что такое тактовый домен, четыре названных в clock_domain.t27 способа его пересечь и что проверяет нативный компилятор.

Тактовый домен — это все триггеры, которые делят один фронт тактового сигнала. Перенесите сигнал между двумя доменами — и принимающий фронт может снять его посреди изменения: этому и посвящён курс. clock_domain.t27 называет в одном перечислении четыре способа перехода: no_cross, two_flop, fifo_async, handshake. Модуль 5 разбирает two_flop, модуль 6 — рукопожатие, модуль 7 — FIFO. Запись запускает нативный t27c на этой спеке: проходят 12 тестов, а 5 инвариантов доказываются при компиляции. Плеер компилирует спеку в браузере; где браузер не может выполнить проверку, он пропускает её и объясняет почему.

Попробуйте

В записи посчитайте прошедшие тесты и доказанные инварианты; затем в окне спеки найдите четыре стратегии пересечения и назовите модуль курса, который разбирает каждую.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on clock_domain.t27 -- the CDC spec, native
t27c on clock_domain.t27 -- the CDC spec, native ↗

t27c 0.4.0 on a laptop (macOS): 12 tests of the clock-domain spec pass natively, 5 invariants proved comptime, and the spec's own header says what it models.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

Один фронт, один мир

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/one-lut-up-close/index.html b/apps/website/public/ru/learn/one-lut-up-close/index.html index ae5680c5b9..01e2619584 100644 --- a/apps/website/public/ru/learn/one-lut-up-close/index.html +++ b/apps/website/public/ru/learn/one-lut-up-close/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Одна LUT вблизи

Вы узнаете

Что такое таблица истинности на 6 входов и как 64 бита описывают любой вентиль.

LUT6 — это крошечная память с 6 адресными входами и 64 однобитными ячейками. Любая логическая функция от 6 входов — это просто её таблица истинности, записанная в эти 64 бита, значение INIT. Вставьте INIT, и виджет прочитает его обратно как таблицу истинности и выражение. Потом сыграйте в угадайку на LUT из настоящего оттрассированного дизайна: XOR, AND, мультиплексор или что-то без короткого имени.

Попробуйте

Попробуйте примеры XOR6 и majority, затем сыграйте пять раундов Guess the gate. В спеке full_adder собран из xor2 и maj3: какая из них даёт перенос и сколько нейронов на неё уходит, по словам спеки?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

LUT explain: a 7-series LUT6 INIT and its FASM line, read as logic
LUT explain: a 7-series LUT6 INIT and its FASM line, read as logic ↗

Paste a 64-bit LUT6 INIT or FASM lines: truth table, minimal expression, the gate's name, what each feature sets. Then guess the gate on 4738 LUTs from a routed design.

specs/ternary/ternary_full_adder.t27

module TernaryFullAdder;
@@ -146,6 +178,7 @@ 

Одна LUT вблизи

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/one-outlier/index.html b/apps/website/public/ru/learn/one-outlier/index.html index 068a837f67..56be8b054a 100644 --- a/apps/website/public/ru/learn/one-outlier/index.html +++ b/apps/website/public/ru/learn/one-outlier/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Один выброс, много нулей

Вы узнаете

Чего стоит общий масштаб: как один крупный вес обнуляет мелкие веса своего блока, формат за форматом.

Общий масштаб задаёт самое большое значение в блоке, поэтому один выброс задаёт его для всех 32 весов. Веса, намного меньшие выброса, падают ниже самого мелкого шага, который может показать элемент, и записываются нулём. Эта запись нативно запускает ocp_mx.t27, нашу спеку OCP MX v1.0, на блоке из 31 мелкого веса и одного выброса и считает, сколько весов обнуляет каждый формат элемента. Затем она подкладывает ошибку, одно изменённое смещение порядка, и падает ровно один тест: спека, которая несёт свои тесты, ловит собственные ошибки.

Попробуйте

Найдите, какой формат элемента обнуляет больше всего мелких весов, а какие два — ни одного; затем найдите тест, который ломает подложенная ошибка. У 4-битного элемента узкий диапазон: в спеке найдите max_value и min_positive у GF4 и два теста, которые их закрепляют.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on ocp_mx.t27 -- OCP MX v1.0, native
t27c on ocp_mx.t27 -- OCP MX v1.0, native ↗

t27c 0.4.0 and zig 0.16.0 on the t27c lab (Railway), spec at t27 1a3786657: 49 tests pass natively; one changed bias makes exactly one test fail; git restores the spec.

specs/numeric/gf4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -373,6 +405,7 @@ 

Один выброс, много нулей

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/one-scale-per-block/index.html b/apps/website/public/ru/learn/one-scale-per-block/index.html index b5ca92ed24..419457fffe 100644 --- a/apps/website/public/ru/learn/one-scale-per-block/index.html +++ b/apps/website/public/ru/learn/one-scale-per-block/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Один масштаб на блок весов

Вы узнаете

Почему ИИ-форматы делят один масштаб на блок весов и как читается байт масштаба OCP MX.

У языковой модели миллионы весов, и хранить и пересылать полное число с плавающей точкой для каждого дорого. Форматы Microscaling (MX) консорциума Open Compute Project хранят каждый вес в 4, 6 или 8 битах и дают каждому блоку из 32 весов один общий масштаб. Этот масштаб — один байт, E8M0: без знака и без мантиссы, только порядок, так что код e означает 2 в степени e минус 127, а код 255 означает NaN. Плеер компилирует e8m0.t27, спеку этого байта, прямо в вашем браузере и запускает её тесты. Проверку, которую браузер выполнить не может, он пропускает и объясняет почему.

Попробуйте

Запустите тесты и посчитайте пропуски; затем откройте Verilog и найдите функцию, которая проверяет код 255. В спеке каталог даёт FP4 E2M1 и MXFP4 одинаковые биты: сравните их поля storage и найдите, что добавляет MXFP4.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

e8m0.t27, the OCP MX scale byte, compiled inside the post
e8m0.t27, the OCP MX scale byte, compiled inside the post ↗

The OCP MX shared scale as a t27 spec, compiled by t27c as WebAssembly in your browser: one byte, 2^(e-127), code 255 is NaN. Seven backends, the spec's own tests and its Verilog.

specs/numeric/formats_catalog.t27

// SPDX-License-Identifier: Apache-2.0
@@ -563,6 +595,7 @@ 

Один масштаб на блок весов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/one-step-downhill/index.html b/apps/website/public/ru/learn/one-step-downhill/index.html index b8a1ea768c..4764bde812 100644 --- a/apps/website/public/ru/learn/one-step-downhill/index.html +++ b/apps/website/public/ru/learn/one-step-downhill/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Один шаг вниз по склону

Вы узнаете

Как один шаг SGD сдвигает вес против градиента и почему тест с двумя равными входами не может их различить.

gft_sgd_step.t27 сдвигает вес против градиента: w' = w - eta*g, где eta — скорость обучения. Её 3 теста: step, где w = 1.0, g = 0.5 и eta = 0.5; nograd, где g = 0 оставляет w как есть; и ascend, где g = -1.0 и eta = 1.0 поднимают w до 2.0. Браузер пропускает все 3 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 3, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который умножает g на само себя вместо eta, и снова t27c test-report. В step g равно eta, а в nograd оба произведения равны 0. Поэтому падает ровно один тест, ascend, где вес падает до 0, вместо того чтобы подняться до 2.0. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке step и решите, какой из его входов нужно изменить, чтобы он поймал ошибку.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_sgd_step.t27 -- one step downhill, native
t27c on gft_sgd_step.t27 -- one step downhill, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 3 tests pass natively, none vacuous; g times g in place of eta times g makes exactly one test fail, ascend; git restores the spec.

specs/ternary/gft_sgd_step.t27

module GftSgdStep;
@@ -196,6 +228,7 @@ 

Один шаг вниз по склону

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/one-task-three-kinds/index.html b/apps/website/public/ru/learn/one-task-three-kinds/index.html index c832e3b23a..02105bedbc 100644 --- a/apps/website/public/ru/learn/one-task-three-kinds/index.html +++ b/apps/website/public/ru/learn/one-task-three-kinds/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Одна задача, три вида

Вы узнаете

Как задача, ревью и фоновая работа становятся одним видом задачи с семью состояниями и как их читает один фильтр.

Королева ведёт работу трёх видов: задачи для пчёл, ревью готовой работы и фоновые работы. У каждого вида были свои коды, и ни одна доска не могла показать их вместе. tasks.t27 даёт им 7 общих состояний, пронумерованных как колонки доски, плюс failed. Отменённая работа показывается как dropped, и так же — забытая строка ревью. task_matches — фильтр, который применяют доска, игра и маршрут: бит на вид, бит на состояние, а 0 значит любое.

Попробовать

Покажите только упавшие задачи всех видов; затем найдите, какое состояние работы показывается как dropped.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

One task, three kinds: the filter the board and the game share
One task, three kinds: the filter the board and the game share ↗

An issue, a review and a job are one kind of task with seven states. Tap kinds and states: the grid lights every pair task_matches lets through.

specs/queen/tasks.t27

// SPDX-License-Identifier: Apache-2.0
@@ -217,6 +249,7 @@ 

Одна задача, три вида

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/one-ternary-neuron/index.html b/apps/website/public/ru/learn/one-ternary-neuron/index.html index b699e72c9c..240999d3d8 100644 --- a/apps/website/public/ru/learn/one-ternary-neuron/index.html +++ b/apps/website/public/ru/learn/one-ternary-neuron/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Один троичный нейрон

Вы узнаете

Как нейрон с весами -1, 0, +1 считает без умножения.

Нейрон умножает каждый вход на вес, складывает произведения и сравнивает сумму с порогом. С троичными весами каждое произведение — копия, ноль или переворот, поэтому сумма — это только сложения и вычитания. activate() спеки отвечает +1 на пороге и выше, -1 на минус пороге и ниже и 0 между ними: нейрон, который умеет сказать «не уверен».

Попробовать

Нарисуйте на входе вертикальную полосу и поднимайте порог, пока нейрон не перестанет срабатывать; затем меняйте веса, пока он не сработает на горизонтальную полосу.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

One ternary neuron: inputs, weights, a threshold
One ternary neuron: inputs, weights, a threshold ↗

Nine inputs and nine weights of -1, 0, +1. Each product is a copy, a zero or a flip; the sum against a threshold gives an output trit.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Один троичный нейрон

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/opposite-signs-subtract/index.html b/apps/website/public/ru/learn/opposite-signs-subtract/index.html index c0098f9c2b..32ce758503 100644 --- a/apps/website/public/ru/learn/opposite-signs-subtract/index.html +++ b/apps/website/public/ru/learn/opposite-signs-subtract/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Разные знаки — вычитание

Вы узнаете

Как сложение чисел со знаком превращается в вычитание, когда знаки разные, и что его 3 теста оставляют непроверенным.

sadd в gft_sadd.t27 складывает два числа одного знака через magadd. Когда знаки разные, она вычитает меньшую величину из большей через magsub, берёт знак большего и при точном сокращении возвращает 0. Браузер пропускает все 3 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 3, все проходят, ни один не пустой. Знаки смешивает только a2, 1.0 плюс -1.0, и они сокращаются: magsub сразу возвращает 0, потому что величины равны. Ни один тест не вычитает две разные величины, поэтому знак большего ни разу не решает результат. Запись запускает t27c test-report, затем однострочный sed, который складывает величины в той ветке, куда попадает a2, и снова t27c test-report: падает ровно один тест, a2. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и значение, которого ждёт a2; затем найдите в спеке bsign и проверьте, зависит ли от него хоть один из a1, a2 и a3.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_sadd.t27 -- opposite signs subtract, native
t27c on gft_sadd.t27 -- opposite signs subtract, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 3 tests pass natively, none vacuous; adding the sizes where opposite signs must subtract makes exactly one test fail, a2; git restores the spec.

specs/ternary/gft_sadd.t27

module GftSadd;
@@ -189,6 +221,7 @@ 

Разные знаки — вычитание

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/patches-of-a-picture/index.html b/apps/website/public/ru/learn/patches-of-a-picture/index.html index 73bfebf141..e8854ac87e 100644 --- a/apps/website/public/ru/learn/patches-of-a-picture/index.html +++ b/apps/website/public/ru/learn/patches-of-a-picture/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Участки картинки

Вы узнаете

Почему сети читают картинку по участкам и что даёт окно 2 x 2, усреднённое по каждому участку.

Картинка это сетка чисел, и сети читают её небольшими участками, чтобы один и тот же детектор работал в любом её месте. Здесь окно 2 x 2 шагает по 2 по картинке 4 x 4, где в клетке i лежит i, и каждый выход это среднее своего участка: 2.5, 4.5, 10.5 и 12.5. При обратном проходе градиент каждого выхода делится поровну на его 4 клетки. Это усредняющий пулинг: свёртка взвешивала бы 4 клетки выученным ядром, и её спека, t27#10612, ещё не слита. Спека avgpool2d_layer.t27 вычисляет оба прохода.

Попробовать

Нажмите на каждый участок и проверьте его среднее на глаз; затем включите градиент и прочитайте, что получает каждая клетка окна 4.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Patches of a picture: a 2 x 2 window, averaged
Patches of a picture: a 2 x 2 window, averaged ↗

Tap a window on the 4 x 4 image: each output is the average of its 2 x 2 patch, two cells apart. Then switch to the gradient and see each output's blame shared out over its patch.

specs/ml/layers/avgpool2d_layer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -290,6 +322,7 @@ 

Участки картинки

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/period-and-jitter/index.html b/apps/website/public/ru/learn/period-and-jitter/index.html index aa46afcbbe..c389cde572 100644 --- a/apps/website/public/ru/learn/period-and-jitter/index.html +++ b/apps/website/public/ru/learn/period-and-jitter/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Период, фронт и джиттер

Вы узнаете

Что несёт тактовый сигнал кроме частоты, что джиттер делает с фронтом и зачем нужна спека карточки инструмента.

Тактовый сигнал — это период с фронтом внутри, и фронт стоит не идеально: от цикла к циклу он гуляет на величину джиттера. Спека карточки инструмента tri clocks — не набор тестов, и запись показывает, как нативный отчёт говорит именно это: 0 тестов, потому что это константы, которые читает страница инструмента. Каждая константа на той карточке называет вывод инструмента, из которого она взята. Джиттер съедает запас, который оставляет расчёт setup: спека дерева тактового сигнала из следующего модуля несёт 50 пс джиттера PLL как одну из своих констант.

Попробуйте

В записи найдите строку, объясняющую, почему отчёт насчитал 0 тестов; затем в окне спеки прочитайте константы и найдите, где каждая называет вывод инструмента, из которого она взята.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on clocks.t27 -- the tri clocks card, native
t27c on clocks.t27 -- the tri clocks card, native ↗

t27c 0.4.0 on a laptop (macOS): the tri clocks tool-card spec reports 0 tests -- it is constants for a tool page, not a test suite; the first lines show what it carries.

specs/tools/trios/tri/clocks.t27

// SPDX-License-Identifier: Apache-2.0
@@ -105,6 +137,7 @@ 

Период, фронт и джиттер

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/phase-and-lock/index.html b/apps/website/public/ru/learn/phase-and-lock/index.html index 8515a97584..40d2b4e58a 100644 --- a/apps/website/public/ru/learn/phase-and-lock/index.html +++ b/apps/website/public/ru/learn/phase-and-lock/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Фаза и захват

Вы узнаете

Насколько мелкая ручка фазы, как ведёт себя модель захвата и что ломает одно расширенное окно.

Фаза движется шагами периода VCO, делённого на 56, — более быстрый VCO даёт более мелкую ручку, поэтому фазовой работе нужен высокий VCO. Захват смоделирован окном установления, которое шапка помечает как допущение. Запись расширяет это допущение одним sed: VCO_MIN_KHZ с 800000 до 400000. Конфигурация на 500 МГц, которую называет тест-отказник, въезжает внутрь расширенного окна, и падает ровно один тест, vco_below_the_window_is_rejected, — тест, называющий число, которое он отвергает, и есть тест, сторожащий допущение. Запись возвращает строку на место и печатает sha256 восстановленной спеки.

Попробуйте

В записи найдите строку sed, упавший тест и sha256 восстановленной спеки; затем в окне спеки вычислите шаг фазы для VCO 1000 МГц.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on mmcm.t27 -- widen the VCO window, one test objects
t27c on mmcm.t27 -- widen the VCO window, one test objects ↗

VCO_MIN_KHZ 800000 to 400000 in one sed: the 500 MHz config the rejection test calls out slides inside the widened window and vco_below_the_window_is_rejected fails; git restores the spec.

specs/fpga/mmcm.t27

// SPDX-License-Identifier: Apache-2.0
@@ -339,6 +371,7 @@ 

Фаза и захват

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/phi-as-a-ratio/index.html b/apps/website/public/ru/learn/phi-as-a-ratio/index.html index 6511c57b35..3770b68d0a 100644 --- a/apps/website/public/ru/learn/phi-as-a-ratio/index.html +++ b/apps/website/public/ru/learn/phi-as-a-ratio/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Phi как отношение

Вы узнаете

Как phi_ratio.t27 считает деление для любой ширины и почему расстояние до 1 / phi уменьшается не на каждом шаге.

phi_ratio.t27 задаёт PHI_RATIO_TARGET равным 1 / phi, около 0.618, а его функция phi_split работает для любой ширины: из N - 1 битов после знака round((N - 1) / phi^2) идут в порядок, остальные в мантиссу. Его таблица verify_phi_split держит семь ширин, и все семь совпадают с семейством: GF4 делится на 1 и 2, GF8 на 3 и 4, GF12 на 4 и 7, GF16 на 6 и 9, GF20 на 7 и 12, GF24 на 9 и 14, GF32 на 12 и 19. Расстояние до 1 / phi падает не на каждом шаге: GF8 с 0.132 дальше, чем GF4 с 0.118, а GF16 с 0.049 дальше, чем GF12 с 0.047.

Попробуйте

Запустите тесты phi_ratio.t27 и найдите тот, что проверяет GF16 на 6 и 9. Затем сравните 3 / 4 и 4 / 7 с 0.618 и скажите, что дальше.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 2: phi as a ratio
GoldenFloat 2: phi as a ratio ↗

Seven widths split by one rule, and how far each sits from 1 / phi, read from phi_ratio.t27. Lesson 2 of the GoldenFloat course.

specs/numeric/phi_ratio.t27

// SPDX-License-Identifier: Apache-2.0
@@ -826,6 +858,7 @@ 

Phi как отношение

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/phi-in-sixteen-bits/index.html b/apps/website/public/ru/learn/phi-in-sixteen-bits/index.html index 28dd12555d..79682181b5 100644 --- a/apps/website/public/ru/learn/phi-in-sixteen-bits/index.html +++ b/apps/website/public/ru/learn/phi-in-sixteen-bits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Phi в шестнадцати битах

Вы узнаете

Как спека проверяет, что GF16 сохраняет phi, phi^2 = phi + 1 и phi^2 + 1/phi^2 = 3 с заявленным допуском.

Формат хорош настолько, насколько он сохраняет тождества. В gf_competitive.t27 пять проверок: phi, записанное в GF16, против его точного значения, phi^2 против phi + 1, сумма phi^2 + 1/phi^2 против 3, туда-обратно и сумма 1000 слагаемых. Читайте их как есть: значения в каждом тесте вписаны в сам тест, а не получены кодировщиком этой спеки. Спека проверяет арифметику ошибки с допусками 1e-4 и 5e-3.

Попробуйте

Запустите тесты и найдите значение, которое каждый тест вписывает для phi^2 и для phi + 1. Затем найдите, какие два теста используют более строгий допуск 1e-4.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 6: phi in sixteen bits
GoldenFloat 6: phi in sixteen bits ↗

The five checks of gf_competitive.t27, read from gf_competitive.t27. Lesson 6 of the GoldenFloat course.

specs/numeric/gf_competitive.t27

// SPDX-License-Identifier: Apache-2.0
@@ -175,6 +207,7 @@ 

Phi в шестнадцати битах

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/phi-scaled-ternary/index.html b/apps/website/public/ru/learn/phi-scaled-ternary/index.html index 4c5675fcef..6e36944ed3 100644 --- a/apps/website/public/ru/learn/phi-scaled-ternary/index.html +++ b/apps/website/public/ru/learn/phi-scaled-ternary/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Веса минус фи, ноль и плюс фи

Вы узнаете

Как тернарный вес хранится в 2 битах, зачем нужен четвёртый код и чего спека не утверждает о фи.

Тернарные сети вроде BitNet хранят каждый вес как минус единицу, ноль или плюс единицу, умноженные на масштаб, так что умножение превращается в сложение, вычитание или ничего. gfternary.t27 фиксирует этот масштаб равным фи, примерно 1,618, и хранит три значения в 2 битах: 00 — ноль, 01 — плюс фи, 10 — минус фи. У двух битов есть четвёртый код, 11, и спека сворачивает его в ноль, а не оставляет неопределённым. Спека говорит и о том, чего не утверждает: что масштаб фи выигрывает у обычных целых тернарных весов — открытая гипотеза, и она называет измеренный разрыв, который её опроверг бы. Плеер компилирует спеку в вашем браузере; большинство проверок здесь выполнить нельзя, и каждый пропуск объясняет почему.

Попробуйте

Запустите тесты и прочитайте, почему пропущенные проверки пропущены; затем найдите код, который сворачивается в ноль, и строку, которая это делает. Золотое сечение может задавать и устройство формата: в спеке найдите golden_section и прочитайте, как gft4 делит 4 позиции между знаком, тритами и мантиссой.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

gfternary.t27, phi-scaled ternary weights, compiled inside the post
gfternary.t27, phi-scaled ternary weights, compiled inside the post ↗

Two-bit ternary weights {-phi, 0, +phi} as a t27 spec, compiled by t27c as WebAssembly in your browser. Seven backends; every test the page cannot run says why.

specs/numeric/gft4.t27

// SPDX-License-Identifier: Apache-2.0
@@ -123,6 +155,7 @@ 

Веса минус фи, ноль и плюс фи

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/pick-the-largest/index.html b/apps/website/public/ru/learn/pick-the-largest/index.html index ce78574876..05fce14cc3 100644 --- a/apps/website/public/ru/learn/pick-the-largest/index.html +++ b/apps/website/public/ru/learn/pick-the-largest/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Выбрать наибольшее

Вы узнаете

Как argmax называет класс, сравнивая одни только биты, и какое правило решает ничью.

Классификатор в конце называет класс с наибольшей оценкой. gft_argmax4.t27 делает это без арифметики: gt ставит отрицательные ниже нуля, ноль ниже положительных, а затем сравнивает младшие 16 бит, растущие с величиной. По заголовку ничью выигрывает меньший индекс, сравнение строгое >. Браузер пропускает все 4 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который меняет > на >= для двух положительных оценок, и снова t27c test-report: падает ровно один тест, tie_low: четыре оценки 1.0 теперь выбирают индекс 3, а не 0. Ни один тест не даёт решить ответ двум отрицательным оценкам: переворот их сравнения ничего не роняет. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем найдите в спеке строку, которая сравнивает две отрицательные оценки, и тот один тест, который до неё доходит.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_argmax4.t27 -- pick the largest, native
t27c on gft_argmax4.t27 -- pick the largest, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; >= in place of > for two positive scores makes exactly one test fail, tie_low; git restores the spec.

specs/ternary/gft_argmax4.t27

module GftArgmax4;
@@ -119,6 +151,7 @@ 

Выбрать наибольшее

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/pins-and-package/index.html b/apps/website/public/ru/learn/pins-and-package/index.html index 2b2f4a8bc8..6b163b8ce1 100644 --- a/apps/website/public/ru/learn/pins-and-package/index.html +++ b/apps/website/public/ru/learn/pins-and-package/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Выводы, шарики и корпус

Вы узнаете

Как сигналы вашего дизайна попадают во внешний мир.

Чип сидит в корпусе: у XC7A200T на нашей плате под ним 676 шариков припоя. Часть несёт питание или конфигурацию, и только часть — пользовательский ввод-вывод, сгруппированный в банки со своим напряжением. Файл ограничений (XDC) говорит, какой шарик использует каждый сигнал дизайна. Поставьте сигнал на шарик, который не является пользовательским IO, и сборка упадёт или, хуже, плата будет делать не то, что вы думаете.

Попробуйте

Найдите шарик по имени, например E3, затем раскрасьте по типу вывода и найдите шарик, который не является пользовательским IO. Спека ставит небольшой дизайн на другой корпус, XC7A100T в CSG324: найдите тест, который сажает такт на шарик E3, и тест, который считает выводы.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Pin map: the XC7A200T FGG676 package ball by ball, with an XDC lint
Pin map: the XC7A200T FGG676 package ball by ball, with an XDC lint ↗

All 676 balls of the XC7A200T FGG676 by bank and type, with our board's pins on top. Paste or drop an XDC: it is linted in your browser and sent nowhere.

specs/boards/xc7a100t_minimal.t27

// SPDX-License-Identifier: Apache-2.0
@@ -460,6 +492,7 @@ 

Выводы, шарики и корпус

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/placement/index.html b/apps/website/public/ru/learn/placement/index.html index 0f30cfc95a..d0d31527c3 100644 --- a/apps/website/public/ru/learn/placement/index.html +++ b/apps/website/public/ru/learn/placement/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Размещение: где оказываются ячейки

Вы узнаете

Что делают размещение и трассировка и куда они поставили настоящий дизайн.

Синтез говорит, какие ячейки нужны. Размещение и трассировка решают, где каждая сидит на кристалле и какие провода их соединяют. В открытом маршруте обе задачи решает nextpnr-xilinx. Карта рисует каждую размещённую ячейку настоящего запуска на XC7A200T: маленький дизайн — маленькое скопление на огромном чипе.

Попробуйте

Подгоните дизайн по размеру, затем нажимайте на ячейки разных типов и читайте их имена BEL. В спеке найдите RegionKind: какие два из пяти его видов — столбцы и какой тест проверяет, что столбец BRAM шириной в 1?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Placement map: where nextpnr put every cell on the XC7A200T
Placement map: where nextpnr put every cell on the XC7A200T ↗

Every LUT, FF, CARRY4, IO and clock buffer of a real nextpnr-xilinx run, drawn on its site of the Artix-7 200T die. Drop your routed JSON and it draws yours.

specs/fpga/placement.t27

// SPDX-License-Identifier: Apache-2.0
@@ -310,6 +342,7 @@ 

Размещение: где оказываются ячейки

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/plan-before-code/index.html b/apps/website/public/ru/learn/plan-before-code/index.html index d2b8f927a8..73afca2fb2 100644 --- a/apps/website/public/ru/learn/plan-before-code/index.html +++ b/apps/website/public/ru/learn/plan-before-code/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сначала план

Вы научитесь

Как план проверки превращается в чек-лист, который команда может прогнать и подписать.

План тестов, записанный после кода, — описание того, что код делает; записанный до кода — требование, которому код обязан соответствовать. В этом репозитории план — это spec, и одна команда его прогоняет. Виджет — такой прогон для инструментов стенда: 14 из 14 проходят собственные самопроверки за один проход — decode 18/18, repin 17/17 — а инструмент, который не может себя проверить, попадает в список, а не в зачёт. Spec урока — build_verify: чек-лист того, что сборка обязана показать, прежде чем кто-то назовёт её готовой.

Попробуйте

Запустите прогон инструментов и найдите инструмент, чья самопроверка перечислена, а не исполнена; затем прочитайте чек-лист build_verify и отметьте, какие пункты — счётчики, а какие — заявления.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-tools · 14 bench tools test themselves
tri fpga-tools · 14 bench tools test themselves ↗

14 of 14 bench tools pass their own self-tests in one sweep: decode 18/18, repin 17/17, firelog 10/10, tmpcheck 9/9, stamps 9/9, keep 9/9, jtag and seeds PASS.

specs/fpga/verification/build_verify.t27

// SPDX-License-Identifier: Apache-2.0
@@ -191,6 +223,7 @@ 

Сначала план

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/pointers-and-flags/index.html b/apps/website/public/ru/learn/pointers-and-flags/index.html index 4aee38fa66..53af398f60 100644 --- a/apps/website/public/ru/learn/pointers-and-flags/index.html +++ b/apps/website/public/ru/learn/pointers-and-flags/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Указатели и флаги

Вы узнаете

Как флаги выводятся из указателей, какие сигналы на самом деле пересекают границу и что ломает одно переприсваивание.

Данные не пересекают границу: они живут в BRAM, и обе стороны адресуют их. Пересекают указатели — по Грею — и флаги, выведенные из них: пусто, когда указатели равны, полно, когда они различаются на глубину. Запись ломает арифметику флагов одним переприсваиванием — push ставит flags.empty в true — и падает ровно один тест, push_increments_fill, который просит у push непустой FIFO. Запись восстанавливает спеку и печатает её sha256. Окно спеки открывает fifo.t27, где push и pop строят флаги, несомые через границу.

Попробуйте

В записи найдите переприсваивание и ровно один упавший тест; затем в окне спеки найдите, где push строит флаги, и выведите пусто из указателей сами.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on fifo.t27 -- break a flag, one test objects
t27c on fifo.t27 -- break a flag, one test objects ↗

push sets flags.empty = false; one sed flips it to true and push_increments_fill fails on the next run; git restores the spec.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Указатели и флаги

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/polyphase/index.html b/apps/website/public/ru/learn/polyphase/index.html index d7e9ba5b32..3ac74e5557 100644 --- a/apps/website/public/ru/learn/polyphase/index.html +++ b/apps/website/public/ru/learn/polyphase/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Полифазная форма

Вы узнаете

Как полифазная форма выполняет фильтрацию дециматора на низкой частоте.

Фильтровать на входной частоте и выбрасывать R - 1 из каждых R выходов — значит тратить впустую R - 1 из каждых R умножений. Раздайте вместо этого отводы по R фазам по правилу k mod R: каждая фаза — короткий фильтр, который встречает только каждый R-й вход, поэтому все они работают на выходной частоте. Фильтр на 31 отвод с децимацией в 4 раза падает со 124 MAC на выходной отсчёт до 31. Спека signals.t27 вычисляет фазы и счётчики.

Попробовать

Найдите число отводов, которое делится на 4 фазы поровну, и такое, которое не делится; затем сравните MAC при R = 8.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Polyphase: do the work at the low rate
Polyphase: do the work at the low rate ↗

Set taps and a decimation factor. The taps are dealt into R short filters that each run at the output rate, and the work per output drops by R.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Полифазная форма

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/ports-and-kinds/index.html b/apps/website/public/ru/learn/ports-and-kinds/index.html index 63e3508438..bc800db7b1 100644 --- a/apps/website/public/ru/learn/ports-and-kinds/index.html +++ b/apps/website/public/ru/learn/ports-and-kinds/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Порты и типы

Вы узнаете

Что такое порт у памяти, сколько их может быть и кому позволено писать.

Порт — это дорога в память: чтение, запись или обе, и MAX_MEM_PORTS 8 их ограничивает. add_read_port_increments, add_write_port_increments и add_rw_port проверяют счёт, is_rom проверяет, что тип только-для-чтения отвергает порт записи. Запись прогоняет t27c check по спеке: 0 ошибок, 0 предупреждений.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите MAX_MEM_PORTS и тест, отвергающий порт записи на ROM.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c check on memory.t27 -- the spec compiles
t27c check on memory.t27 -- the spec compiles ↗

t27c check typechecks the memory spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/memory.t27

// SPDX-License-Identifier: Apache-2.0
@@ -422,6 +454,7 @@ 

Порты и типы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/positional-encoding/index.html b/apps/website/public/ru/learn/positional-encoding/index.html index b796c13faa..60a384679d 100644 --- a/apps/website/public/ru/learn/positional-encoding/index.html +++ b/apps/website/public/ru/learn/positional-encoding/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Позиционное кодирование

Вы узнаете

Как синусы и косинусы убывающих частот дают каждой позиции свой вектор и почему сдвиг это поворот.

Внимание видит свой вход как множество, поэтому порядок слов нужно к ним добавить. Синусоидальное кодирование даёт каждой позиции d чисел: sin и cos позиции, умноженной на частоту, которая от пары к паре падает в 10000^(2/d) раз. При d = 8 четыре пары поворачиваются на 1, 0.1, 0.01 и 0.001 радиана за позицию, как стрелки четырёх часов: позиция 5 читает -0.959, 0.284 в быстрой паре и 0.005, 1.000 в медленной. Длина каждой пары равна 1, и сдвиг на k позиций поворачивает каждую пару на свой постоянный угол. Спека positional_encoding.t27 вычисляет каждое значение.

Попробовать

Шагните с позиции 0 на 1 и посмотрите, какие часы двигаются; затем перейдите на 37 и найдите пару, которая всё ещё смотрит вверх.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Positional encoding: how a transformer knows word order
Positional encoding: how a transformer knows word order ↗

Every position gets 8 numbers, sines and cosines at frequencies falling by 10 per pair. Drag the position: the fast clock spins, the slow ones barely move, and the stripes show all 48 rows.

specs/ml/transformer/positional_encoding.t27

// SPDX-License-Identifier: Apache-2.0
@@ -156,6 +188,7 @@ 

Позиционное кодирование

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/ppo-and-the-reward/index.html b/apps/website/public/ru/learn/ppo-and-the-reward/index.html index 952562832a..abf9b7dffc 100644 --- a/apps/website/public/ru/learn/ppo-and-the-reward/index.html +++ b/apps/website/public/ru/learn/ppo-and-the-reward/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

PPO и награда

Вы узнаете

Как PPO превращает награду в обновление политики и как его обрезка не даёт одному обновлению зайти слишком далеко.

Агент учится на награде, делая хорошие действия вероятнее. PPO измеряет изменение политики отношением r новой вероятности действия к старой и умножает его на преимущество A, насколько действие превзошло ожидание. Затем он обрезает: когда r ушло больше чем на eps в ту сторону, за которую награждает A, цель становится плоской. При r = 1.5, A = 1 и eps 0.2 сырое r A равно 1.5, но PPO засчитывает 1.2, так что один пакет не может далеко сдвинуть политику. На пакете спеки, отношения 1, 1.1 и 0.9 с преимуществами 2, 1.5 и 3, потеря политики равна -2.1167. Спека ppo_clip_loss.t27 её вычисляет.

Попробовать

Сделайте преимущество отрицательным и найдите, где кривая теперь становится плоской; затем расширьте eps до 0.5.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

PPO: how an agent learns from reward without lurching
PPO: how an agent learns from reward without lurching ↗

Drag the probability ratio of a new policy over the old: PPO's objective follows r times the advantage until r moves more than eps the rewarded way, then it goes flat and stops pulling.

specs/ml/rl/ppo_clip_loss.t27

// SPDX-License-Identifier: Apache-2.0
@@ -265,6 +297,7 @@ 

PPO и награда

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/prefix-adders/index.html b/apps/website/public/ru/learn/prefix-adders/index.html index 44c9a7b592..ff258a0931 100644 --- a/apps/website/public/ru/learn/prefix-adders/index.html +++ b/apps/website/public/ru/learn/prefix-adders/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Взгляд вперёд: префиксные сумматоры

Вы узнаете

Как префиксная сеть вычисляет все переносы за log2 n уровней и чем за это платят Kogge-Stone, Sklansky и Brent-Kung.

Переносы сумматора — это префиксы одного ассоциативного оператора, поэтому их можно считать деревом, а не цепью. Виджет рисует четыре сети по функции src() спеки, по точке на каждую префиксную ячейку. На 16 битах ripple нужно 15 уровней; Kogge-Stone — 4 уровня и 49 ячеек, Brent-Kung — 7 уровней и 26 ячеек, Sklansky — 4 уровня и 32 ячейки при коэффициенте разветвления 8. Спека не принимает эти числа на веру: covers() прогоняет каждую сеть на отрезках и проверяет, что каждый столбец в итоге покрывает биты от 0 до i.

Попробовать

На 16 битах нажмите на бит 15 в каждой сети и сосчитайте белые точки; затем назовите сеть с наименьшим числом уровней и сеть с наименьшим числом ячеек.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Prefix adders: trade logic levels for cells and wires
Prefix adders: trade logic levels for cells and wires ↗

Pick a width and a network -- ripple, Sklansky, Kogge-Stone, Brent-Kung -- and see every carry cell. Tap a bit to light the cells its carry waits for.

specs/fpga/dsp/adders.t27

// SPDX-License-Identifier: Apache-2.0
@@ -552,6 +584,7 @@ 

Взгляд вперёд: префиксные сумматоры

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/psel-and-penable/index.html b/apps/website/public/ru/learn/psel-and-penable/index.html index e2e37ffb35..d085ad8a0b 100644 --- a/apps/website/public/ru/learn/psel-and-penable/index.html +++ b/apps/website/public/ru/learn/psel-and-penable/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

PSEL и PENABLE

Вы узнаете

Как работает двухфазное рукопожатие APB и что компилятор порождает для моста.

APB ведёт пересылку в две фазы: setup, где PSEL называет слугу и адрес оседает, и access, где поднимается PENABLE и пересылка завершается. Перечисление ApbTransfer спеки несёт виды, а стенд двенадцатого урока гоняет через них запись и чтение. Запись опускает спеку моста APB в синтезируемый Verilog: список портов, разводку, дешифрацию.

Попробовать

В записи найдите список портов моста; затем в спеке найдите виды ApbTransfer и скажите, какую фазу называет PENABLE.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on apb_bridge.t27 -- spec to RTL
t27c gen-verilog on apb_bridge.t27 -- spec to RTL ↗

The APB bridge spec lowered to synthesizable Verilog: port list, PSEL and PENABLE wiring, the address decode.

specs/fpga/apb_bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -415,6 +447,7 @@ 

PSEL и PENABLE

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/pub-or-private/index.html b/apps/website/public/ru/learn/pub-or-private/index.html index 86dc0f4753..6961d25a76 100644 --- a/apps/website/public/ru/learn/pub-or-private/index.html +++ b/apps/website/public/ru/learn/pub-or-private/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

pub или закрытое имя

Вы узнаете

Что объявляет pub и что пишет бэкенд TypeScript с ним и без него.

pub перед const, fn, struct или enum говорит, что имя могут использовать другие модули. Без pub имя предназначено самому модулю. Сегодня компилятор не соблюдает это в коде, который пишет: gen-ts экспортирует и pub-константу, и закрытую константу спеки урока. Используйте pub, чтобы сказать, что модуль предлагает, и читайте сгенерированный код, прежде чем полагаться на закрытость.

Попробуйте

Откройте вкладку ts спеки урока в плеере и найдите обе константы.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 16: what pub changes in the generated code
t27 basics 16: what pub changes in the generated code ↗

A pub and a private t27 constant side by side with the TypeScript the real compiler wrote for each. Lesson 16 of the t27 basics course.

specs/basics/16_pub_or_private.t27

// SPDX-License-Identifier: Apache-2.0
@@ -81,6 +113,7 @@ 

pub или закрытое имя

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/q-formats/index.html b/apps/website/public/ru/learn/q-formats/index.html index e3c0d11aae..c938e50e30 100644 --- a/apps/website/public/ru/learn/q-formats/index.html +++ b/apps/website/public/ru/learn/q-formats/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Форматы Q

Вы узнаете

Как читать и записывать слово Qm.n с фиксированной точкой: его диапазон, шаг и биты вокруг двоичной точки.

В Qm.n m целых бит вместе со знаком и n дробных; слово означает своё целое значение, умноженное на 2^-n. Q1.15 — 16-битное слово от -1 до 0.99997 с шагом 2^-15. У 0.7 нет точного слова Q1.15: ближайшее — 22938, оно стоит 0.70001. Старший бит весит минус свою позицию — в этом и весь дополнительный код. Спека fixed_point.t27 вычисляет диапазон, шаг, каждый бит и слово, к которому округляется значение.

Попробовать

Запишите 0.7 в Q1.15 и прочитайте ошибку; затем переключитесь на Q2.2 и перечислите все значения, которые держит формат.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Q formats: read and write a fixed-point number
Q formats: read and write a fixed-point number ↗

Pick Qm.n, drag a value or tap the bits, and see where the binary point sits, what the word is worth, its range and its step.

specs/fpga/dsp/fixed_point.t27

// SPDX-License-Identifier: Apache-2.0
@@ -344,6 +376,7 @@ 

Форматы Q

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/quantization-noise/index.html b/apps/website/public/ru/learn/quantization-noise/index.html index b9cc0c21f3..df7010b77a 100644 --- a/apps/website/public/ru/learn/quantization-noise/index.html +++ b/apps/website/public/ru/learn/quantization-noise/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Шум квантования

Вы узнаете

Почему каждый бит квантователя даёт около 6 дБ и где формула из учебника слишком оптимистична.

Ошибка квантователя — пила высотой в один шаг, и её мощность равна квадрату шага, делённому на 12. Для синуса полной шкалы это даёт 6.02 N + 1.76 дБ, около 74.0 дБ на 12 битах. Спека signals.t27 ещё и измеряет это: она квантует настоящий синус на 4096 отсчётах, в которых 127 периодов, и делит мощности. На 12 битах они совпадают; на 1 бите формула обещает 7.78 дБ, а измерение находит 6.44, потому что столь грубая ошибка не равномерна.

Попробовать

Пройдите от 1 до 4 бит и посмотрите, как сходится разрыв между формулой и измерением; затем прочитайте, что добавляет 16-й бит.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Quantization noise: each bit buys about 6 dB
Quantization noise: each bit buys about 6 dB ↗

Pick a quantizer width and see the staircase, its error, and the signal-to-noise ratio measured on a real sine next to the textbook 6.02 N + 1.76 dB.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Шум квантования

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/queen-and-hive/all/card.png b/apps/website/public/ru/learn/queen-and-hive/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..f2fd09604d4d9dc74f6852309a34aca98cb90fb5 GIT binary patch literal 45388 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 + + + + + +Королева и улей: как проект t27 строит себя сам: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

Королева и улей: как проект t27 строит себя сам

+

Этот проект строит себя сам: задача становится работой для пчелы, пчела пишет спеку t27, пчела-ревьюер её проверяет, спеку сливают, и сайт пересобирается. Королева, которая ведёт этот цикл, записана спеками t27 с тестами, и каждый виджет здесь исполняет тела fn одной из них, скомпилированные в WebAssembly.

+

Курс 11, 27 уроков, в каждом живой виджет и спека t27: оформление задачи, приоритет и сначала ревью, жизнь задачи, ревьюер и ворота слияния, затор ревью, ключи, заслуги и токены, агенты в одной группе, ночной дозор и доска. Каждый ответ даёт скомпилированная спека.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

0 из 27 пройдено

+

Открыть интерактивный курс →

+
+

Модуль 1 · Задача

Задача становится работой, только когда её оформили: недостающие разделы дописаны или запрошены, граница называет настоящие файлы, а один фильтр читает задачи всех видов.

+
+
01

Урок 1 из 27

Оформление задачи

+
+

Вы узнаетеЧто Королева делает с задачей без нужных разделов и почему останавливается после двух попыток.

Пчела может начать только задачу, в которой сказано, что сделать и каких файлов можно касаться. Королева проверяет каждую открытую задачу функцией judge() из specs/policy/issue_shape.t27. Неготовую она оформляет: модель дописывает недостающие разделы, и текст возвращается в задачу, только если judge() больше ничего не находит. После SHAPE_ATTEMPT_LIMIT, 2 неудачных попыток, она останавливается и один раз пишет комментарий, чего не хватает, а эпик не оформляется никогда. Решает shape_action в shaping.t27, а новая попытка ждёт 360 минут.

Попробовать

Поставьте два недостающих раздела и пройдите попытки; затем отметьте, что автору уже написали, и посмотрите, в какую колонку попадёт задача.

+
Shaping: what the Queen does with an issue that is not readyВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/shaping.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Граница из настоящих файлов

+
+

Вы узнаетеКакие предложенные пути задача может забронировать и почему один выдуманный путь останавливает всё оформление.

Граница задачи — это бронь: пока пчела работает, другие пчёлы эти файлы не берут. Поэтому неверная граница хуже отсутствующей: она держит файлы, которые работе не принадлежат. path_accepted принимает любой существующий файл, а новый — только если существует его папка, задача его упоминает и язык разрешён правилом only-t27. shape_lands возвращает оформление в задачу, только если все разделы на месте, путей от 1 до 12 и ни один не отклонён.

Попробовать

Сделайте два красных пути зелёными, меняя только то, что может быть правдой; затем оставьте раздел недописанным и посмотрите на ворота.

+
A boundary: which files a task may reserveВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/shaping.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Одна задача, три вида

+
+

Вы узнаетеКак задача, ревью и фоновая работа становятся одним видом задачи с семью состояниями и как их читает один фильтр.

Королева ведёт работу трёх видов: задачи для пчёл, ревью готовой работы и фоновые работы. У каждого вида были свои коды, и ни одна доска не могла показать их вместе. tasks.t27 даёт им 7 общих состояний, пронумерованных как колонки доски, плюс failed. Отменённая работа показывается как dropped, и так же — забытая строка ревью. task_matches — фильтр, который применяют доска, игра и маршрут: бит на вид, бит на состояние, а 0 значит любое.

Попробовать

Покажите только упавшие задачи всех видов; затем найдите, какое состояние работы показывается как dropped.

+
One task, three kinds: the filter the board and the game shareВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/tasks.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Кто следующий

Порядок, в котором Королева берёт задачи: метка стареет на одну ступень, критичными идут не больше 3, и ничего нового не начинается, пока готовая работа ждёт ревью.

+
+
04

Урок 4 из 27

Старение метки

+
+

Вы узнаетеКак задача с меткой поднимается с возрастом и почему только на один уровень.

Без меток Королева берёт задачи в том порядке, в котором их выдаёт GitHub. priority.t27 добавляет четыре уровня: critical, high, normal и low; меньший идёт раньше, а задача без метки считается normal. Задача с меткой поднимается на уровень через AGING_DAYS, 14 дней, и не больше чем на MAX_AGING_STEPS, 1 уровень, так что low доходит до normal на 14-й день и там остаётся. High и critical не стареют. Линию в виджете вычисляет effective_level.

Попробовать

Найдите день, когда задача с меткой low поднимается; затем снимите метку и дотяните до 60-го дня.

+
Aging: how long a labelled low issue waitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/priority.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Очередь

+
+

Вы узнаетеКак потолок, старение и блокеры упорядочивают очередь открытых задач.

Метки раздуваются: если каждая задача критична, критичных нет. capped_level позволяет идти как critical не больше чем CRITICAL_CAP, 3, задачам списка, в порядке списка, а 4-я идёт как high. Задача с открытым блокером пропускается, её не ждут, и она не может задержать очередь. outranks сравнивает уровень с учётом старения, затем настоящий уровень, затем место в списке, так что постаревшая задача никогда не обгонит настоящую своего уровня. why называет причину каждого места.

Попробовать

Сделайте критичной пятую задачу и посмотрите, куда она встанет; затем поставьте задаче без метки метку low.

+
The queue: which issue the Queen takes firstВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/priority.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Сначала ревью

+
+

Вы узнаетеПочему Королева закрывает бэклог, пока готовая работа ждёт ревью, и что всё равно идёт.

На 2026-10-18 страница статуса показывала 69 из 70 занятых воркеров, а за час — 102 запуска, 56 завершённых и 11 проверенных. Пчёл запускалось примерно девять на каждый вердикт, и каждая новая пчела держала файлы, нужные пчёлам на ревью, когда их возвращали. review_first.t27 закрывает бэклог, пока очередь ревью длиннее REVIEW_QUEUE_MAX, 0. Работа, которую ревью вернуло, и работа, назначенная владельцем, всё равно идут: admission пропускает их при любой длине очереди.

Попробовать

Перетащите очередь на 0 и обратно на 1; затем найдите кандидатов, которых пропускают при любой длине.

+
Review first: no new work while finished work waitsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/review_first.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Жизнь пчелы

От кандидата до готовой работы: двенадцать состояний и шестнадцать событий, корабль в игре, который улетает домой, и деплой, который не обрывает пчелу.

+
+
07

Урок 7 из 27

Жизнь задачи

+
+

Вы узнаетеЧерез какие состояния проходит запущенная задача и какие события допустимы в каждом.

dispatch.t27 — жизненный цикл задачи у Королевы, цикл, который выбирает, запускает, завершает, проверяет и отпускает работу. У задачи 12 состояний и 16 событий. next_state отвечает на каждую пару, а 99 значит, что событие в этом состоянии недопустимо: вердикт не доходит до работающей задачи, а снятие — до завершённой. После вердикта возврат ждёт свой порог и отпускается; даже принятую работу возвращают, если CI краснеет ниже потолка.

Попробовать

Проведите задачу от none до accept; затем сделайте CI красным на потолке и найдите выход, который остаётся.

+
A task's life: the Queen's state machineВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/dispatch.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Корабль летит домой

+
+

Вы узнаетеГде игра рисует пчелу в каждом её занятии и как завершённая задача заканчивается на экране.

В игре на app.t27.ai/game каждая пчела — корабль над задачей, над которой она работает. ship_mode в hive.t27 выбирает место: стоянка у входа, пока раннер её не взял, облёт своей ячейки, пока от неё приходят вести, зависание, когда она замолчала, и ожидание у портала своего репозитория, пока ячейку не поставили. Когда пчела уходит из ленты, она летит домой, и ship_alpha гасит её за DEPART_MS, 2400 мс: через 1200 мс у неё 500 из 1000.

Попробовать

Отметьте, что от пчелы давно нет вестей, и посмотрите, куда она сдвинется; затем протяните время дальше 2400 мс.

+
The game: where a bee flies and how it leavesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/hive.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Деплой на лету

+
+

Вы узнаетеЧто передеплой делает с пчелой, ревью, раундом, фоновой работой и ожиданием.

Каждое слияние передеплоивает Королеву, а в этот момент идёт работа. drain.t27 её сортирует. Раунд, шаг фоновой работы и строка ожидания — это строки, которые хранит база: процесс их оставляет, и следующий продолжает. Ревью останавливается: остановка теряет не больше одного ревью, и его делают заново. Пчелу держат, потому что сделанное ею живёт в её разговоре; на потолке, drain_cap_seconds, сегодня 1800 с, её возвращают, а работу сохраняют в её ветку.

Попробовать

Протяните ожидание от 0 до потолка и посмотрите, как меняется строка пчелы; затем сократите дренаж платформы до 1000 с.

+
A deploy mid-flight: what happens to a running beeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/drain.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Пчела-ревьюер

Готовую работу судят по своим часам: столько ревью сразу, чтобы успевать, пауза, которая удваивается для строки в ожидании, и ворота слияния, которые не открыть без проверок.

+
+
10

Урок 10 из 27

Хватит ли ревьюеров

+
+

Вы узнаетеСколько ревью должно идти сразу, чтобы ревьюер успевал за пчёлами.

Ревью может занять REVIEW_ROW_SECONDS, 300 с, поэтому один слот проверяет не больше 12 строк в час. На 2026-10-09 пчёлы заканчивали около 58 в час, пока ждали 111 строк, а постоянный REVIEWER_CONCURRENCY, равный 4, даёт не больше 48. slots_needed(58) равно 5. reviewer_concurrency учитывает ключи, их полосы и свободную память, никогда не поднимается выше 16 и не опускается ниже 1, пока что-то ждёт, а keeps_up сравнивает это с темпом завершения.

Попробовать

Найдите наименьшее число ключей с 1 полосой, при котором ревьюер успевает за 58 в час; затем урежьте память до 1000 МБ.

+
How many reviewer bees: keeping up with the finish rateВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/reviewer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Отступить

+
+

Вы узнаетеПочему строку, которая отвечает wait, проверяют всё реже и как часто хотя бы.

За 44 минуты на 2026-10-09 ревьюер сделал 941 визит к строкам, из них 888 с ответом wait, от 22 строк, чью ветку он не мог прочитать; одну строку проверили 54 раза. Теперь revisit_after_seconds ждёт 30 с после одного wait и удваивает паузу на каждый следующий, не больше 900 с: 30, 60, 120, 240, 480, 900. due_again даёт взять строку, только когда это время прошло, а любой другой ответ сбрасывает счёт.

Попробовать

Найдите число ожиданий, после которого пауза перестаёт расти; затем поставьте 4 ожидания и найдите секунду, когда строка снова к сроку.

+
Back off: when the reviewer looks at a waiting row againВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/reviewer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Ворота слияния

+
+

Вы узнаетеКогда мерджер может слить пулл-реквест, который одобрила пчела-ревьюер.

Пчела-ревьюер одобряет, мерджер сливает; merger_gate.t27 — правило между ними. check_passes пропускает зелёную проверку и задерживает любую, которая ещё идёт. Красная проходит, только если она не обязательная, завершилась и пчела назвала её списанной, а если набор правил не читается, обязательной считается каждая проверка. gate_open нужен хотя бы 1 опубликованный результат, 0 идущих и 0 блокирующих: ноль проверок — не ноль падений.

Попробовать

Дайте идущей проверке завершиться зелёной; затем сделайте набор правил нечитаемым и посмотрите на списанную красную.

+
The merge gate: when an approved pull request may mergeВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/merger_gate.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Затор ревью

Застрявший пулл-реквест всегда в одном из десяти случаев, у каждого свой ход Королевы, а красная проверка считается унаследованной, только если так говорит master.

+
+
13

Урок 13 из 27

Затор ревью

+
+

Вы узнаетеВ каком из десяти случаев застрявший пулл-реквест и почему побеждает правило, совпавшее раньше остальных.

Пулл-реквест может застрять сразу по нескольким причинам: отклонён, снова запушен и красный на шумовой проверке. review-jam.t27 даёт Королеве один ответ. jam_case проверяет 9 фактов в постоянном порядке, и побеждает правило, совпавшее раньше остальных, так что PR, который Королева не смогла измерить, никогда не считается свободным, а отклонённый и затем запушенный не принимается за шум. Случаев 10, от none до unmeasured.

Попробовать

Снимайте факты по одному со стартового состояния и называйте каждый случай; затем найдите PR, который ни в каком заторе.

+
The review jam: which case a stuck pull request is inВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/review-jam.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Ход Королевы

+
+

Вы узнаетеЧто Королева делает в каждом заторе и каких заторов она ждёт.

У каждого случая одно действие на той же позиции: no reviewer отправляет ревьюера, refused not fixed отправляет кодера, refused then pushed отправляет повторное ревью, а labeled not merged завершает слияние. jam_action переводит любое значение больше 9 в measure again, так что неизвестный случай никогда не значит «делать нечего». jam_is_queens_turn ложно для 3 случаев — none, draft or fresh и stacked on an open PR: их она ждёт.

Попробовать

Найдите случай, чьё действие — ждать базу; затем дотяните до 200 и прочитайте действие.

+
The Queen's move: what each jam asks of herВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/review-jam.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Унаследованный красный

+
+

Вы узнаетеКогда красная проверка пулл-реквеста унаследована от master и почему отменённый запуск ничего не говорит.

Пчела может одобрить PR с красной проверкой, если эта проверка красная и в master. На 2026-10-06 PR слили красным, потому что запуск этой проверки в master был отменён и прочитан как красный. Теперь мерджер сам читает master, начиная с самого нового запуска: run_says учитывает только завершённое падение или успех, look_back пропускает всё остальное и запуски старше базы слияния, а discount_holds нужны слово пчелы и MASTER RED.

Попробовать

Сделайте все запуски отменёнными; затем передвиньте падение раньше базы слияния и посмотрите на ворота.

+
Inherited red: what master's runs say about a red checkВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/merger_gate.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Ключи

Ключ модели у пчелы могут отклонить: код в теле ответа сортирует отказ, временный отказ даёт ключу отдохнуть секунды, и пчела переходит к следующему свободному ключу.

+
+
16

Урок 16 из 27

Отклонённый ключ

+
+

Вы узнаетеКак Королева сортирует отказ провайдера: временный, квота, доступ или неверный запрос.

Пчёлы обращаются к моделям по ключам, и ключи отклоняют. key_failover.t27 сортирует каждый отказ функцией error_kind. Код z.ai в теле ответа важнее статуса HTTP, потому что z.ai отвечает одним и тем же 429 и на исчерпанную квоту, и на временную перегрузку: код 1305 временный, 1113 — квота. Отсутствие ответа — тоже временный отказ. Отказ по квоте или доступу закрывает ключ, а в счёт задачи идёт только неверный запрос.

Попробовать

Сравните 429 с кодами 1308 и 1312; затем прочитайте, что значит отсутствие ответа.

+
A refused key: transient, quota, auth or a bad requestВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/key_failover.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Ключ отдыхает

+
+

Вы узнаетеСколько отклонённый ключ отдыхает, прежде чем пчела сможет взять его снова.

Временный отказ даёт ключу отдохнуть COOL_BASE_SECONDS, 15 с, вдвое больше за каждый отказ подряд и не больше COOL_CAP_SECONDS, 240 с: 15, 30, 60, 120, 240. Исчерпанная квота или отклонённый ключ закрывают его на KEY_BREAK_SECONDS, 1800 с. Всё это даёт cooldown_seconds. Отдых короткий, чтобы 34 ключа никогда не отдыхали все сразу во время минутного всплеска, как на 2026-10-17.

Попробовать

Найдите число отказов, после которого отдых перестаёт расти; затем переключите на квоту и прочитайте отдых.

+
How long a refused key restsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/key_failover.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Следующий ключ

+
+

Вы узнаетеКакой ключ пчела пробует следующим и когда переходит к другому пулу или сдаётся.

На 2026-10-17 пчела начала на ключе 9 из 10 и погибла через 7 с, пока 33 других ключа простаивали: она получила один ключ при запуске и держала его. Теперь next_free берёт следующий после последнего ключ, который ещё не пробовали и который не отдыхает. 1305 — перегрузка модели пула, поэтому, когда POOL_OVERLOAD_KEYS, 3, ключа сказали это за минуту, step переводит пчелу в следующий пул. После 8 попыток ход заканчивается.

Попробовать

Отметьте ключ 2 как опробованный и посмотрите, какой ключ получит кольцо; затем поставьте три ключа, ответивших 1305.

+
The next key: a bee moves on instead of dyingВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/key_failover.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Заслуги и деньги

Одолженный ключ не приносит заслуг, операция продаётся вдвое дороже своей цены в токенах по полцента, а токены сгорают через 30 дней после зачисления.

+
+
19

Урок 19 из 27

Ключи не дают заслуг

+
+

Вы узнаетеЧто приносят ключи, которые одолжил участник, и какие пределы их берегут.

Любой может одолжить улью ключи моделей через queen-contributor-keys.t27. Ключ проверяют, прежде чем включить: не больше 4 проверок сразу, новая проверка ждёт 60 с после прошлой, а у одного владельца не больше 100 ключей. Сам по себе ключ ничего не приносит: CREDIT_WALLET ложно, поэтому wallet_credit отвечает 0 при любом числе ключей. Опыт следует за работой, которую записывает Королева.

Попробовать

Протяните число ключей от 0 до 100 и посмотрите на счётчик заслуг; затем найдите секунду, когда можно начать проверку.

+
Lending a key earns no credit: XP follows recorded workВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/queen-contributor-keys.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Вдвое дороже цены

+
+

Вы узнаетеКак проект назначает цену операции и что покупает месяц токенов.

Каждый доллар становится токенами по одному курсу, TOKEN_MICRO_USD 5000: токен — полцента. price_tokens продаёт операцию вдвое дороже её стоимости, MARKUP_PCT 200, и округляет вверх, чтобы ничего не продавалось дешевле: стоимость 12300 микродолларов — это 5 токенов. month_tokens превращает $20 в 4000 токенов, то есть 14 рилсов по 270 токенов или 333 портрета по 12.

Попробовать

Найдите стоимости, которые дают ровно 1 токен; затем найдите месячную цену, на которую выходит 36 рилсов.

+
The price of an operation: twice its cost, rounded upВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/token-wallet.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

Сгорающие токены

+
+

Вы узнаетеКогда сгорает партия токенов и какая партия тратится раньше.

Правило владельца от 2026-10-01: все деньги уходят в токены, а токены, не потраченные за месяц, сгорают, так что заплативший делает контент, а не копит токены. Каждая партия живёт MONTH_DAYS, 30 дней, и days_left отсчитывает её от дня зачисления. На 25-й день у пакета месяца с дня 0 осталось 5 дней, у стартового подарка с дня 3 — 8, у пополнения с дня 12 — 17. Тратится раньше та, что сгорит раньше.

Попробовать

Найдите день, когда сгорает пакет месяца; затем найдите последний день, когда остаётся хоть одна партия.

+
Tokens that burn: a month to spend themВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/token-wallet.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Агенты между собой

У каждого агента свой бот в одной группе: кого зовут, цепочка глубиной в три сообщения ботов и часы, которые не дают агентам завалить чат.

+
+
22

Урок 22 из 27

Кого зовут

+
+

Вы узнаетеКакие сообщения в группе улья будят агента — от человека и от бота другого агента.

У каждого агента свой бот и своя тема в одной форумной группе. Человек зовёт агента его тегом, через @all, ответом на сообщение или просто сообщением в его теме. Бот другого агента зовёт его только тегом или ответом: бот никогда не поднимает весь улей и не будит хозяина темы, просто написав в ней. addressed в agent-hive-group.t27 — это правило длиной в одну строку.

Попробовать

Найдите два способа, которыми агента может позвать только человек; затем включите все четыре и сравните отправителей.

+
Who is called: an agent bot in a group of agentsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/agent-hive-group.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Три бота в глубину

+
+

Вы узнаетеКак улей не даёт агентам отвечать друг другу бесконечно.

Telegram не защищает ботов от зацикливания, так что два агента могли бы отвечать друг другу вечно. Это останавливают два числа. MAX_BOT_DEPTH равно 3: человек, затем A, B и C, затем тишина. BOT_REPLY_COOLDOWN_MS равно 5000: бот отвечает другому боту не чаще раза в 5 с. may_answer всегда пропускает человека, а бота — только внутри цепочки и после паузы.

Попробовать

Найдите промежуток, при котором агент B замолкает; затем объясните, почему молчит и C.

+
Chain depth: human, A, B, C, then silenceВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/agent-hive-group.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Stop и mute

+
+

Вы узнаетеЧто делают /stop и /mute и почему ни один не теряет человека или прямой вызов.

cooled говорит, прошло ли 5000 мс с последнего сообщения бота. /stop глушит разговоры ботов между собой в чате на STOP_WINDOW_MS, 10 минут, а человека по-прежнему слышно: это may_answer_after_stop. /mute заставляет агента молчать в теме MUTE_MS, час, но на свой тег он отвечает: heard_while_muted. Оба — часы, поэтому никому не нужно включать улей обратно.

Попробовать

Протяните часы /stop дальше 10 минут; затем позовите тегом заглушённого агента.

+
The cooldown clock, /stop and /muteВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/agent-hive-group.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · Ночь и доска

Что показывает улей: ночной дозор, который открывает, комментирует и закрывает задачи, колонки публичной доски и соты, которые вспыхивают на каждое событие.

+
+
25

Урок 25 из 27

Ночной дозор

+
+

Вы узнаетеЧто ночной дозор делает утром с четырьмя проверками карточек.

Каждую ночь идут четыре проверки чата карточек: тред, дверь статуса, слияния и паритет. night_verdict подводит итог: любое падение — это падение, иначе любое неизмеренное — неизмерено, иначе всё прошло. night_report превращает это в одно действие: падение открывает задачу или комментирует открытую, успех закрывает открытую задачу или молчит, а неизмеренная ночь оставляет всё как есть.

Попробовать

Сделайте ночь успешной при открытой задаче; затем сделайте одну проверку неизмеренной.

+
The night watch: four checks, one verdict, one reportВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/automation/card-chat-night-watch.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Публичная доска

+
+

Вы узнаетеВ какой колонке публичная доска рисует каждое притязание и в каком случае ошибается.

Доска на app.t27.ai/game/kanban рисует каждый запуск в одной из 6 колонок. column_of читает притязание запуска на его задачу: running — в работе, accepted — готово, rejected и awaiting review — на ревью, failed — сброшено. dispatch.t27 записывает одну находку как есть: когда задача закрыта и список прочитан, любое завершённое притязание рисуется как готовое, каким бы ни был вердикт.

Попробовать

Откройте задачу и посмотрите, куда уйдут четыре завершённых притязания; затем скажите, что скрывает закрытая задача.

+
The public board: which column a task's card is inВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/dispatch.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Соты отвечают

+
+

Вы узнаетеКак игра показывает, что с задачей что-то случилось, и как часто растёт карта.

В сотах игры у каждой задачи своя ячейка, и до hive.t27 принятая задача, потерянная аренда и отмена выглядели так же, как отсутствие новостей. cell_effect даёт каждому из 10 видов событий свою краску: старт белый, принявшее ревью золотое, возврат янтарный, потерянная аренда красная, отмена серая. flash_alpha гасит вспышку за FLASH_MS, 1800 мс. Новая ячейка перестраивает сцену, поэтому cells_due ставит новые ячейки пачками не чаще раза в 300 с.

Попробовать

Нажмите ячейку ревью и переключите вердикт; затем найдите момент, когда вспышка гаснет.

+
The comb answers: what an event does to a cellВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/queen/hive.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Задача
    1. 01 Оформление задачи
    2. 02 Граница из настоящих файлов
    3. 03 Одна задача, три вида
  2. 02 · Кто следующий
    1. 04 Старение метки
    2. 05 Очередь
    3. 06 Сначала ревью
  3. 03 · Жизнь пчелы
    1. 07 Жизнь задачи
    2. 08 Корабль летит домой
    3. 09 Деплой на лету
  4. 04 · Пчела-ревьюер
    1. 10 Хватит ли ревьюеров
    2. 11 Отступить
    3. 12 Ворота слияния
  5. 05 · Затор ревью
    1. 13 Затор ревью
    2. 14 Ход Королевы
    3. 15 Унаследованный красный
  6. 06 · Ключи
    1. 16 Отклонённый ключ
    2. 17 Ключ отдыхает
    3. 18 Следующий ключ
  7. 07 · Заслуги и деньги
    1. 19 Ключи не дают заслуг
    2. 20 Вдвое дороже цены
    3. 21 Сгорающие токены
  8. 08 · Агенты между собой
    1. 22 Кого зовут
    2. 23 Три бота в глубину
    3. 24 Stop и mute
  9. 09 · Ночь и доска
    1. 25 Ночной дозор
    2. 26 Публичная доска
    3. 27 Соты отвечают
+ + + + + diff --git a/apps/website/public/ru/learn/queen-and-hive/index.html b/apps/website/public/ru/learn/queen-and-hive/index.html index 123d4b8aad..fc882b6c16 100644 --- a/apps/website/public/ru/learn/queen-and-hive/index.html +++ b/apps/website/public/ru/learn/queen-and-hive/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

Королева и улей: как проект t27 строит себя сам

Этот проект строит себя сам: задача становится работой для пчелы, пчела пишет спеку t27, пчела-ревьюер её проверяет, спеку сливают, и сайт пересобирается. Королева, которая ведёт этот цикл, записана спеками t27 с тестами, и каждый виджет здесь исполняет тела fn одной из них, скомпилированные в WebAssembly.

Курс 11, 27 уроков, в каждом живой виджет и спека t27: оформление задачи, приоритет и сначала ревью, жизнь задачи, ревьюер и ворота слияния, затор ревью, ключи, заслуги и токены, агенты в одной группе, ночной дозор и доска. Каждый ответ даёт скомпилированная спека.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/questions-in-thirds/index.html b/apps/website/public/ru/learn/questions-in-thirds/index.html index cc0395c66f..35e122b380 100644 --- a/apps/website/public/ru/learn/questions-in-thirds/index.html +++ b/apps/website/public/ru/learn/questions-in-thirds/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Вопросы по третям

Вы узнаете

Почему вопросы с тремя ответами находят число быстрее и попутно записывают его.

Спрашивайте, в какой трети диапазона лежит загаданное число, и каждый ответ будет одним из трёх: нижняя, средняя, верхняя. На диапазоне -121..121 ответы сверху вниз — это ровно пять тритов числа. Среди 243 чисел нужно 5 вопросов; вопросам «да или нет» нужно 8. questions3() и questions2() спеки считают оба случая.

Попробовать

Загадайте 23 и спрашивайте, пока оно не найдётся; затем загадайте -121 и скажите, какими были все ответы.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Twenty questions in thirds
Twenty questions in thirds ↗

Hide a number. Each question asks which third it lies in; the answers are its trits, top first. 243 numbers take 5 questions instead of 8.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Вопросы по третям

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/read-a-bitstream/index.html b/apps/website/public/ru/learn/read-a-bitstream/index.html index 1a5a6b6a5b..2b1f1fe3c5 100644 --- a/apps/website/public/ru/learn/read-a-bitstream/index.html +++ b/apps/website/public/ru/learn/read-a-bitstream/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Читаем битстрим

Вы узнаете

Что внутри файла .bit и для какого чипа он собран.

Файл .bit — это заголовок, за которым идут пакеты: команды логике конфигурации чипа и сами фреймы. Одна из этих команд записывает IDCODE чипа, для которого файл собран. Бросьте .bit во вскрытие и увидите, какой чип он просит. Пять битстримов, закоммиченных в t27, оказываются собраны для другой детали, чем наш стенд.

Попробуйте

Откройте пример blink_j26 и сравните деталь в его заголовке с IDCODE, который он записывает. В спеке прочитайте HELP_LINE: с каким эталонным инструментом tri x7-writer совпадает байт в байт и какой вход он отвергает?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Bitstream autopsy: which FPGA a 7-series .bit really targets
Bitstream autopsy: which FPGA a 7-series .bit really targets ↗

Drop a Xilinx 7-series .bit: header, the IDCODE it writes and the part that names, frames, zero bytes and packets, read in your browser. Nothing is uploaded.

specs/tools/trios/tri/x7-writer.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Читаем битстрим

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/reading-errors/index.html b/apps/website/public/ru/learn/reading-errors/index.html index 27548b9d42..b1124df73b 100644 --- a/apps/website/public/ru/learn/reading-errors/index.html +++ b/apps/website/public/ru/learn/reading-errors/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Как читать ошибки компилятора

Вы узнаете

Как читать строку и столбец ошибки на четырёх настоящих промахах.

Ошибка разбора говорит, где был парсер, около какой строки и какой токен он не ждал, с номером строки и столбца. Ошибка типов называет константу и почему её значение не помещается. Сначала прочитайте позицию, потом посмотрите на токен левее: промах часто стоит прямо перед местом, где парсер остановился. Таблица показывает, что ответил компилятор этого сайта на четыре маленьких промаха.

Попробуйте

Повторите в плеере каждый из четырёх промахов и сверьте строку и столбец с таблицей.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 25: four mistakes and what t27c says
t27 basics 25: four mistakes and what t27c says ↗

Four small mistakes in a t27 spec and the exact message the real compiler printed for each. Lesson 25 of the t27 basics course.

specs/basics/25_reading_errors.t27

// SPDX-License-Identifier: Apache-2.0
@@ -79,6 +111,7 @@ 

Как читать ошибки компилятора

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/related-or-not/index.html b/apps/website/public/ru/learn/related-or-not/index.html index 9b1a46e48f..345b828e92 100644 --- a/apps/website/public/ru/learn/related-or-not/index.html +++ b/apps/website/public/ru/learn/related-or-not/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Родственные или чужие

Вы узнаете

Когда анализатор проверяет путь между двумя тактовыми сигналами и когда ему надо сказать, что они чужие.

Два тактовых сигнала родственны, когда один сделан из другого — через MMCM из модуля 3 — и тогда каждый путь между ними хронометрируется: анализатор знает об общем происхождении. Чужим такая проверка не положена, пока вы её не объявите. timing.t27 — арифметика этой проверки: дуги, запас (slack) и Fmax с учебной моделью Artix-7: LUT 0,1 нс, BRAM 2,0 нс, DSP 2,5 нс, трассировка 0,3 нс. Запись запускает нативный t27c: проходят 25 тестов, 2 инварианта comptime. Родственные клоки были модулем 3; безопасность чужих — это модули с 5 по 7.

Попробуйте

В записи посчитайте прошедшие тесты; затем в окне спеки найдите четыре учебные задержки шапки и функцию, превращающую дуги в запас.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on timing.t27 -- static timing, native
t27c on timing.t27 -- static timing, native ↗

t27c 0.4.0 on a laptop (macOS): 25 tests of the timing spec pass natively, 2 invariants comptime -- arcs, slack, Fmax and the Artix-7 teaching delays (LUT 0.1 ns, BRAM 2.0 ns, DSP 2.5 ns).

specs/fpga/timing.t27

// SPDX-License-Identifier: Apache-2.0
@@ -446,6 +478,7 @@ 

Родственные или чужие

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/relu/index.html b/apps/website/public/ru/learn/relu/index.html index 825676940d..3dcaaf36be 100644 --- a/apps/website/public/ru/learn/relu/index.html +++ b/apps/website/public/ru/learn/relu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

ReLU: оставить положительную часть

Вы узнаете

Что ReLU делает с положительным и с отрицательным входом и почему наклон 0 останавливает обучение нейрона.

Нейрон складывает взвешенные входы и пропускает сумму через функцию активации. ReLU из них самая простая, max(0, x): положительная сумма проходит без изменений, отрицательная становится 0. Её наклон равен 1 или 0, а наклон 0 означает нейрон, который перестал учиться: градиент через него назад не течёт. Утечка это исправляет: с наклоном 0.1 вход x = -2 даёт -0.2 и пропускает назад градиент 0.1. Спека relu_activation.t27 вычисляет обе кривые, которые рисует виджет.

Попробовать

Поставьте x на -2 и прочитайте наклон с утечкой и без неё; затем найдите наклон при x = 1.5.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

ReLU: what a neuron does with a negative number
ReLU: what a neuron does with a negative number ↗

Drag along the curve and watch ReLU pass every positive input and zero every negative one; give it a leaky slope and a little of the negative side gets through.

specs/ml/activation/relu_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -203,6 +235,7 @@ 

ReLU: оставить положительную часть

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/reset-fanout/index.html b/apps/website/public/ru/learn/reset-fanout/index.html index 1ed7168b72..25b64ee8f2 100644 --- a/apps/website/public/ru/learn/reset-fanout/index.html +++ b/apps/website/public/ru/learn/reset-fanout/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Разветвление сброса

Вы узнаете

Почему сброс растит дерево, как тактовое, и где его цена видна в настоящем подсчёте ресурсов.

Сброс доходит до каждого триггера дизайна, поэтому он растит дерево, как тактовое, и балансируется по той же причине: неровное снятие — это перекос, который вы построили сами. Виджет считает настоящую разведённую схему против собственных итогов XC7A200T, прочитанных из chipdb и prjxray-db, и посчитает вашу, если бросить её разведённый JSON. Дерево сброса живёт в том же бюджете: трассировка и давление control set, видимые ровно в этих столбиках. Окно спеки снова открывает cts.t27 — арифметику дерева, общую для обоих деревьев.

Попробуйте

В виджете прочитайте итоги, против которых считаются столбики; затем в окне спеки найдите целевой перекос, под который балансируется и дерево сброса.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-rxcap
tri fpga-rxcap ↗

Per-bit setup and hold of an asynchronous RX nibble sampled by RXC, from the routed SDF: the four rxd bits of one nibble change 2387 to 2486 ps apart, so a binary counter tears where a gray one cannot.

specs/fpga/cts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -292,6 +324,7 @@ 

Разветвление сброса

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/reset-release/index.html b/apps/website/public/ru/learn/reset-release/index.html index 610b31c184..88d3caa869 100644 --- a/apps/website/public/ru/learn/reset-release/index.html +++ b/apps/website/public/ru/learn/reset-release/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Конвейер снятия

Вы узнаете

Как снятие сброса проходит по сдвиговому регистру и что компилятор для него генерирует.

Снятие идёт по сдвиговому регистру: на такте приёмника триггер за триггером берёт значение соседа, и сброс держится, пока конвейер не опустеет. Задержка равна числу ступеней — 2 ступени снимаются за 2 такта, 3 за 3. Запись показывает, что компилятор генерирует для модели: t27c gen печатает Zig, и функция step — это копирование структуры, по одному полю на триггер, и ничего больше. wc -l в конце записи — размер всей сгенерированной модели.

Попробуйте

В записи найдите число из wc -l; затем в окне спеки найдите after_clocks() и проверьте, что задержка снятия равна числу ступеней.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen on reset_sync.t27 -- the release pipe as Zig
t27c gen on reset_sync.t27 -- the release pipe as Zig ↗

t27c gen prints what it compiled: the step function is a Zig struct copy, one field per flop, and wc -l says how many lines the whole model took.

specs/fpga/reset_sync.t27

// SPDX-License-Identifier: Apache-2.0
@@ -327,6 +359,7 @@ 

Конвейер снятия

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/review-first/index.html b/apps/website/public/ru/learn/review-first/index.html index 8633e6b8b7..878d7cd1f8 100644 --- a/apps/website/public/ru/learn/review-first/index.html +++ b/apps/website/public/ru/learn/review-first/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сначала ревью

Вы узнаете

Почему Королева закрывает бэклог, пока готовая работа ждёт ревью, и что всё равно идёт.

На 2026-10-18 страница статуса показывала 69 из 70 занятых воркеров, а за час — 102 запуска, 56 завершённых и 11 проверенных. Пчёл запускалось примерно девять на каждый вердикт, и каждая новая пчела держала файлы, нужные пчёлам на ревью, когда их возвращали. review_first.t27 закрывает бэклог, пока очередь ревью длиннее REVIEW_QUEUE_MAX, 0. Работа, которую ревью вернуло, и работа, назначенная владельцем, всё равно идут: admission пропускает их при любой длине очереди.

Попробовать

Перетащите очередь на 0 и обратно на 1; затем найдите кандидатов, которых пропускают при любой длине.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Review first: no new work while finished work waits
Review first: no new work while finished work waits ↗

Drag the review queue. While anything waits in review, a backlog issue is refused; work the review sent back and work the owner assigned still go.

specs/queen/review_first.t27

// SPDX-License-Identifier: Apache-2.0
@@ -243,6 +275,7 @@ 

Сначала ревью

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/rgmii-timing/index.html b/apps/website/public/ru/learn/rgmii-timing/index.html index 5be62bb460..872e44d29e 100644 --- a/apps/website/public/ru/learn/rgmii-timing/index.html +++ b/apps/website/public/ru/learn/rgmii-timing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Тайминг RGMII

Вы узнаете

Что тайминг RGMII требует от полубайта на двух фронтах и что спека о нём утверждает.

RGMII переносит полубайт за фронт такта, на обоих фронтах: двойная скорость данных на 125 МГц для гигабита и одинарная для 10 и 100. Спека этого урока, написанная для этого курса, несёт тайминговую арифметику и свои допущения в заголовке. Запись прогоняет t27c по ней.

Попробовать

В записи проследите прогон; затем в спеке найдите частоту DDR и что спека говорит о понижении до 10 и 100.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on rgmii.t27 -- RGMII timing, native
t27c on rgmii.t27 -- RGMII timing, native ↗

t27c test-report on the RGMII spec: 7 tests pass natively plus one comptime invariant -- the 8 ns gigabit period, a nibble on both edges, the 78 ps tap ladder.

specs/fpga/rgmii.t27

// SPDX-License-Identifier: Apache-2.0
@@ -184,6 +216,7 @@ 

Тайминг RGMII

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/ripple-carry/index.html b/apps/website/public/ru/learn/ripple-carry/index.html index 805fc9ccfc..f9c6ab0ffa 100644 --- a/apps/website/public/ru/learn/ripple-carry/index.html +++ b/apps/website/public/ru/learn/ripple-carry/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сквозной перенос

Вы узнаете

Как ряд полных сумматоров складывает два числа, а перенос идёт влево.

Поставьте полные сумматоры в ряд, по одному на разряд, и подавайте перенос каждого в следующий: получится сумматор со сквозным переносом. Виджет открывается на 13 + 1: разряд единиц даёт 2 = 3 - 1, поэтому перенос +1 проходит три разряда, и +++ превращается в +---. ripple_add() спеки сверяется с обычным сложением на 198 парах. Спека урока собирает 2-битный двоичный сумматор со сквозным переносом из тех же троичных деталей.

Попробовать

Нажмите запуск и остановитесь на столбце, где перенос впервые снова становится 0; затем попробуйте 40 + 41.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Ripple carry: add two numbers trit by trit
Ripple carry: add two numbers trit by trit ↗

Two numbers, one full adder per place, the carry walking left. Press play to watch every column decide its sum.

specs/ternary/ternary_ripple_adder.t27

module TernaryRippleAdder;
@@ -157,6 +189,7 @@ 

Сквозной перенос

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/rmsprop/index.html b/apps/website/public/ru/learn/rmsprop/index.html index 1f38ad8cac..3eb91d91d2 100644 --- a/apps/website/public/ru/learn/rmsprop/index.html +++ b/apps/website/public/ru/learn/rmsprop/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

RMSProp: шаг без масштаба

Вы узнаете

Как RMSProp делит каждый шаг на скользящий корень среднего квадрата, чтобы шаг больше не зависел от величины градиента.

Правильный размер шага зависит от величины градиента, а разные веса видят градиенты, отличающиеся в миллион раз. RMSProp хранит скользящее среднее квадрата градиента, кэш, и делит каждый шаг на его корень, поэтому у шага нет единиц: при постоянном градиенте 0.001, 0.5 или 1000 вес на шаге 1 сдвигается ровно на те же 0.0316 и идёт тем же путём, доходя до -0.0914 после 100 шагов при lr 0.01. Затухание задаёт, как медленно наполняется кэш: при 0.99 те же 100 шагов заканчиваются на -1.0261. Спека rmsprop.t27 вычисляет вес и кэш.

Попробовать

Переключайтесь между тремя градиентами и убедитесь, что линии не двигаются; затем поднимите затухание до 0.99.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

RMSProp: a step that does not care how big the gradient is
RMSProp: a step that does not care how big the gradient is ↗

Feed one weight a constant gradient of 0.001, 0.5 or 1000: RMSProp divides by the root of its running mean square, so all three walk the same path. Change the decay and the path bends.

specs/ml/optimizer/rmsprop.t27

// SPDX-License-Identifier: Apache-2.0
@@ -167,6 +199,7 @@ 

RMSProp: шаг без масштаба

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/rotating-by-shifts/index.html b/apps/website/public/ru/learn/rotating-by-shifts/index.html index 988eda11a8..eb6248441d 100644 --- a/apps/website/public/ru/learn/rotating-by-shifts/index.html +++ b/apps/website/public/ru/learn/rotating-by-shifts/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Поворот сдвигами

Вы узнаете

Как режим вращения CORDIC получает cos и sin одними сдвигами и сложениями.

На шаге i поворачивайте вектор на atan(2^-i) в ту или другую сторону: умножение на tan — это сдвиг на i, так что каждый шаг — два сдвига и два сложения. Выбор направления по знаку оставшегося угла сводит этот угол к нулю, а старт с K(n) вместо 1 компенсирует растяжение, которое добавляет каждый шаг; K(n) стремится к 0.6072529350. После 16 шагов 30 градусов дают cos 0.866018 и sin 0.500013. Спека cordic.t27 вычисляет каждый шаг, который рисует виджет.

Попробовать

Прогоните 30 градусов за 4 шага, а затем за 16, и прочитайте ошибки; затем найдите шаг, на котором направление впервые меняется на поворот по часовой стрелке.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

CORDIC: rotate a vector with shifts and adds
CORDIC: rotate a vector with shifts and adds ↗

Set an angle and a number of steps and watch the vector turn by ever smaller angles, each one only a shift and an add, until it lands on cos and sin.

specs/fpga/dsp/cordic.t27

// SPDX-License-Identifier: Apache-2.0
@@ -437,6 +469,7 @@ 

Поворот сдвигами

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/rounding-and-saturation/index.html b/apps/website/public/ru/learn/rounding-and-saturation/index.html index 080f96b013..3012801135 100644 --- a/apps/website/public/ru/learn/rounding-and-saturation/index.html +++ b/apps/website/public/ru/learn/rounding-and-saturation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Округление и насыщение

Вы узнаете

Что усечение, округление и конвергентное округление делают со значением и с его средним и когда заворачивать, а когда насыщать.

Отбросить младшие биты — значит усечь, а усечение смещено: на линейном нарастании его средняя ошибка равна -0.25 LSB для одного отброшенного бита и стремится к -0.5, когда их больше. Округление половины вверх смещено в другую сторону, +0.25 для одного бита; конвергентное округление отправляет ничьи к чётному соседу и в среднем даёт 0. За пределами диапазона сумматор в дополнительном коде заворачивает бесплатно, превращая 1.0 в -1.0 в Q1.15; насыщение стоит компаратора и сохраняет знак. Спека fixed_point.t27 измеряет все три режима на нарастании.

Попробовать

Запишите 1.25 в Q3.1 каждым режимом округления и отметьте сохранённое значение; затем отбросьте 4 бита и прочитайте три смещения.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Rounding and saturation: the error you choose, and its bias
Rounding and saturation: the error you choose, and its bias ↗

Drag a value into a small Qm.n and switch between truncation, rounding and convergent rounding, and between wrap and saturate. The bars show which rounding is biased.

specs/fpga/dsp/fixed_point.t27

// SPDX-License-Identifier: Apache-2.0
@@ -344,6 +376,7 @@ 

Округление и насыщение

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/run-a-program/index.html b/apps/website/public/ru/learn/run-a-program/index.html index 6e1a973c47..e5693d20be 100644 --- a/apps/website/public/ru/learn/run-a-program/index.html +++ b/apps/website/public/ru/learn/run-a-program/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Запустить программу

Вы узнаете

Как пять команд и один переход на три стороны дают цикл, который сам себя завершает.

У машины виджета три 9-тритных регистра и пять команд: SET, ADD, DEC, BR3 и HALT. Сумма 1..n кладёт n в r1, прибавляет его к r0, уменьшает, и BR3 прыгает назад, пока r1 положителен; на 0 выполнение проходит к HALT. При n = 5 машина останавливается с r0 = 15. Спека урока описывает контейнер .tbin, в котором поставляется программа TRI-27, так, как его читает загрузчик Trinity.

Попробовать

Пройдите программу суммы по тактам при n = 3; затем запустите 7 x n при n = 12 и посчитайте такты.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Run a program on a ternary machine
Run a program on a ternary machine ↗

Two short programs on three 9-trit registers: sum 1..n and multiply by repeated adds. Step a clock at a time and watch the trits change.

specs/isa/tri27_bytecode.t27

// SPDX-License-Identifier: Apache-2.0
@@ -276,6 +308,7 @@ 

Запустить программу

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/same-bits-on-the-board/index.html b/apps/website/public/ru/learn/same-bits-on-the-board/index.html index e4929a0cf5..77b1d55c26 100644 --- a/apps/website/public/ru/learn/same-bits-on-the-board/index.html +++ b/apps/website/public/ru/learn/same-bits-on-the-board/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Те же биты — на плате

Вы узнаете

Как показать, что битстрим совпадает байт в байт и что он работает.

Утверждение, в котором сомневается большинство людей из FPGA: битстрим, собранный открытым маршрутом из спек t27, совпадает байт в байт с эталонным тулчейном и работает на настоящей плате. Эта запись сравнивает файлы, загружает биты в SRAM чипа и считает квитанции, которые присылает плата. Бросьте два файла .bit в bit-diff, чтобы проверить совпадение сами.

Попробуйте

Дождитесь счёта квитанций в конце, затем попробуйте bit-diff в «Ещё попробуйте». В спеке ACTIONS перечисляет шаги tri x7-board: какой из них загружает SRAM чипа и какой флаг ему нужен по HELP_LINE?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A bitstream from t27 specs, run on the AX7203
A bitstream from t27 specs, run on the AX7203 ↗

Byte-identical to openXC7's .bit, loaded into SRAM, 51,840 of 51,840 tagged receipts on the board.

specs/tools/trios/tri/x7-board.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Те же биты — на плате

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/same-neuron-new-weights/index.html b/apps/website/public/ru/learn/same-neuron-new-weights/index.html index 86ccdb8acf..694c49b1ab 100644 --- a/apps/website/public/ru/learn/same-neuron-new-weights/index.html +++ b/apps/website/public/ru/learn/same-neuron-new-weights/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Тот же нейрон, другие веса

Вы узнаете

Как один тернарный нейрон считает голосование большинством с одними весами и другую функцию — с другими.

maj3 в bitnet_majority.t27 упаковывает три трита через pack3, берёт dot27 с w_all_p, куском весов из одних P, и квантует с порогом 0: результат — знак a + b + c. weighted_vote — тот же нейрон с весами pack3(2, 2, 0), и он даёт знак a + b - c: функцию выбирают веса. Браузер пропускает все 12 тестов, потому что пока не знает assert_eq; нативный t27c запускает все 12, все проходят, ни один не пустой. Запись уменьшает w_all_p на 16, и вес на дорожке 2 из P становится Z: maj3 больше не видит c. Падает ровно один тест, maj_p_n_n: +1 - 1 - 1 даёт N, а +1 - 1 даёт Z. Заметьте: wv_p_z_p передаёт средним входом 0, то есть N, а не Z. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи ожидаемое и полученное значение maj_p_n_n; затем найдите в спеке wv_p_z_p и вычислите, что вернёт weighted_vote(2, 1, 2).

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on bitnet_majority.t27 -- One neuron, two functions, native
t27c on bitnet_majority.t27 -- One neuron, two functions, native ↗

t27c on the t27c lab (Railway), spec at t27 5ff0ec512: 12 tests pass natively; one maj3 weight moved from P to Z fails exactly one test, maj_p_n_n; git restores the spec.

specs/ternary/bitnet_majority.t27

module BitnetMajority;
@@ -133,6 +165,7 @@ 

Тот же нейрон, другие веса

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/sampling-and-aliasing/index.html b/apps/website/public/ru/learn/sampling-and-aliasing/index.html index 5b05d88cf6..2e56e756d6 100644 --- a/apps/website/public/ru/learn/sampling-and-aliasing/index.html +++ b/apps/website/public/ru/learn/sampling-and-aliasing/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Дискретизация и наложение спектров

Вы узнаете

Почему тон выше половины частоты дискретизации возвращается более низким и в какую сторону он отражается.

Дискретизатор видит тон на f как тон на |f - fs round(f/fs)|: спектр складывается, как бумага, на каждом кратном fs/2. При частоте 100 тон на 70 виден на 30, как и тон на 130. В каждой второй зоне Найквиста складка идёт в обратную сторону, и псевдочастота выходит зеркальной. Временной вид показывает, почему ничто после дискретизатора не отличит их: отсчёты тона 70 лежат точно на тоне 30. Спека signals.t27 вычисляет складку, зону и каждую нарисованную точку.

Попробовать

Найдите три входные частоты, которые попадают на 30 при частоте 100; затем двигайте fs и смотрите, как смещаются углы треугольника.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Sampling and aliasing: the fold of every frequency
Sampling and aliasing: the fold of every frequency ↗

Set a tone and a sample rate: the tone folds back into 0 .. fs/2 like paper, and below, its samples fit a lower tone exactly.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Дискретизация и наложение спектров

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/scale-byte-native/index.html b/apps/website/public/ru/learn/scale-byte-native/index.html index e1a27e4353..878d43767f 100644 --- a/apps/website/public/ru/learn/scale-byte-native/index.html +++ b/apps/website/public/ru/learn/scale-byte-native/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Байт масштаба на настоящей машине

Вы узнаете

Что нативный компилятор проверяет в той же спеке, включая то, что браузер пропустил.

Плеер в прошлом уроке не смог выполнить все проверки в e8m0.t27 и прямо об этом сказал. Эта запись запускает нативный t27c и Zig на настоящей машине на той же спеке: её константы, отчёт о тестах, тесты Zig и Verilog для проверки на NaN. Часть проверок — инварианты, которые компилятор доказывает во время компиляции, так что компиляция и есть проверка. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите, сколько инвариантов отчёт доказал во время компиляции, и сравните число пройденных тестов с числом у плеера.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on e8m0.t27 -- the MX shared scale byte, native
t27c on e8m0.t27 -- the MX shared scale byte, native ↗

t27c 0.4.0 and zig 0.16.0 on the t27c lab (Railway): the E8M0 scale byte of OCP MX, 18 tests and 9 comptime invariants pass, and the Verilog backend's NaN check.

specs/numeric/e8m0.t27

// SPDX-License-Identifier: Apache-2.0
@@ -334,6 +366,7 @@ 

Байт масштаба на настоящей машине

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/self-checking/index.html b/apps/website/public/ru/learn/self-checking/index.html index 91decc099b..51ad8cd799 100644 --- a/apps/website/public/ru/learn/self-checking/index.html +++ b/apps/website/public/ru/learn/self-checking/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Самопроверка вместо всматривания

Вы научитесь

Как написать тестбенч, который падает громко, и почему разглядывание волн — не проверка.

Тестбенч, который печатает волны и останавливается, — машина по производству всматривания. Самопроверяющийся тестбенч вычисляет вердикт и выходит с ненулевым кодом при провале, поэтому скрипт может прогнать тысячу таких и доверять коду возврата. Виджет — терминал для семи бэкендов t27: каждая команда прогнана на hello_world, 21 прошла, 0 упало — и каждый проход заработан ассертом, который исполнился, а не фактом завершения. Spec урока, spi_tb, заканчивается так же: счёт проверок и режим отказа, который нельзя принять за успех.

Попробуйте

Откройте терминал семи бэкендов и найдите команду, чей проход не исполнил ни одного ассерта; затем найдите в spi_tb режим отказа, который не может напечатать «ok».

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 play · the terminal's own gates
t27 play · the terminal's own gates ↗

The terminal for seven t27 backends: every command run on hello_world. 21 pass, 0 fail.

specs/fpga/testbench/spi_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Самопроверка вместо всматривания

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/setup-hold-window/index.html b/apps/website/public/ru/learn/setup-hold-window/index.html index 22e003edd6..9a292d1d99 100644 --- a/apps/website/public/ru/learn/setup-hold-window/index.html +++ b/apps/website/public/ru/learn/setup-hold-window/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Окно setup-hold

Вы узнаете

Что значат setup и hold, что делает триггер при попадании в окно и что показывает из этого VCD.

У каждого триггера есть окно вокруг снимающего фронта — setup до него, hold после. Попади переход внутрь окна — и триггер не выберет уровень чисто: выход может зависнуть между 0 и 1, метастабильное состояние, разрешающееся во времени, которого datasheet не обещает. Виджет читает .vcd из любого симулятора и сообщает смены значений, самый загруженный сигнал и сигналы, застрявшие в X или Z: X в симуляции — способ тестбенча показать, что окно нарушено. Окно спеки открывает clock_domain.t27, чью модель пересечения модуль 5 превращает в арифметику.

Попробуйте

В виджете бросьте .vcd, если он у вас есть, и найдите самый загруженный сигнал; затем в окне спеки найдите модель пересечения, которой принадлежит окно.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-rxer
tri fpga-rxer ↗

RX_ER pulses injected at exact nibble positions of a ping -- preamble, mid-frame, IP header -- and the frame state each pulse leaves behind, RTL vs model.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

Окно setup-hold

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/seven-backends-and-t27b/index.html b/apps/website/public/ru/learn/seven-backends-and-t27b/index.html index 6dd5462ba0..2e1e2886d3 100644 --- a/apps/website/public/ru/learn/seven-backends-and-t27b/index.html +++ b/apps/website/public/ru/learn/seven-backends-and-t27b/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Семь бэкендов и t27b

Вы узнаете

Одна спека, много целевых языков и нативный компилятор без LLVM.

Одна спека t27 может стать Zig, C, Rust, JavaScript, TypeScript или Verilog; Verilog получается двумя путями, прямо из спеки и через HIR, — вот и семь бэкендов. Плеер показывает Rust, который t27c пишет для hello_world. t27b — второй компилятор: нативный машинный код AArch64, без LLVM, JIT для тестов и объектные файлы Mach-O. Он не закончен, и мы говорим, насколько: в запуске 26c447ad8 он прошёл 307 из 449 спек, которые эталонный компилятор проходит с тестами, 68.4%.

Попробуйте

Переключите плеер на JavaScript в «Ещё попробуйте», сгенерируйте модуль и запустите его.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

hello_world.t27 to Rust, in a terminal inside the post
hello_world.t27 to Rust, in a terminal inside the post ↗

A terminal in your browser running the t27 compiler as WebAssembly: t27c gen rust prints the Rust it emits for hello_world.t27, and t27c test runs the spec's tests.

specs/tutorial/08_modules_and_arrays.t27

// SPDX-License-Identifier: Apache-2.0
@@ -157,6 +189,7 @@ 

Семь бэкендов и t27b

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/seven-backends/index.html b/apps/website/public/ru/learn/seven-backends/index.html index 4fb59e8457..6248acb378 100644 --- a/apps/website/public/ru/learn/seven-backends/index.html +++ b/apps/website/public/ru/learn/seven-backends/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Семь бэкендов

Вы узнаете

Имена 7 бэкендов и сколько кода каждый написал для одной маленькой спеки.

У компилятора в вашем браузере 7 бэкендов: c, js, rust, ts, verilog, verilog_hir и zig. Каждый читает одну и ту же разобранную спеку и пишет код на своём языке; бэкенд verilog_hir пишется из аппаратного представления, HIR. Таблица показывает, сколько байтов написал каждый бэкенд для спеки урока, по замеру компилятором этого сайта. Больше не значит выше качеством: каждому языку нужно разное количество текста.

Попробуйте

Откройте в плеере каждую вкладку бэкенда спеки урока и найдите функцию add.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 22: one spec, seven backends
t27 basics 22: one spec, seven backends ↗

How many bytes each of the 7 t27c backends wrote for one small spec, measured with the real compiler. Lesson 22 of the t27 basics course.

specs/basics/22_seven_backends.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

Семь бэкендов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/shaping-an-issue/index.html b/apps/website/public/ru/learn/shaping-an-issue/index.html index 4aaa307266..01000dfb55 100644 --- a/apps/website/public/ru/learn/shaping-an-issue/index.html +++ b/apps/website/public/ru/learn/shaping-an-issue/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Оформление задачи

Вы узнаете

Что Королева делает с задачей без нужных разделов и почему останавливается после двух попыток.

Пчела может начать только задачу, в которой сказано, что сделать и каких файлов можно касаться. Королева проверяет каждую открытую задачу функцией judge() из specs/policy/issue_shape.t27. Неготовую она оформляет: модель дописывает недостающие разделы, и текст возвращается в задачу, только если judge() больше ничего не находит. После SHAPE_ATTEMPT_LIMIT, 2 неудачных попыток, она останавливается и один раз пишет комментарий, чего не хватает, а эпик не оформляется никогда. Решает shape_action в shaping.t27, а новая попытка ждёт 360 минут.

Попробовать

Поставьте два недостающих раздела и пройдите попытки; затем отметьте, что автору уже написали, и посмотрите, в какую колонку попадёт задача.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Shaping: what the Queen does with an issue that is not ready
Shaping: what the Queen does with an issue that is not ready ↗

Set how many sections an issue lacks and how often shaping failed: the Queen leaves it, shapes it, or tells its author once what is missing.

specs/queen/shaping.t27

// SPDX-License-Identifier: Apache-2.0
@@ -198,6 +230,7 @@ 

Оформление задачи

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/shift-and-add/index.html b/apps/website/public/ru/learn/shift-and-add/index.html index 03b444b626..f38495f54f 100644 --- a/apps/website/public/ru/learn/shift-and-add/index.html +++ b/apps/website/public/ru/learn/shift-and-add/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сдвиг и сложение

Вы узнаете

Почему умножитель — это стопка сдвинутых частичных произведений и сколько их стоит число.

Каждый бит множителя, равный 1, добавляет копию множимого, сдвинутую на позицию этого бита; каждый бит 0 не добавляет ничего. 200 x 13 — это 200 + 800 + 1600 = 2600, три строки из восьми. Два 8-битных числа дают не больше чем 16-битное произведение, а матричный умножитель — ровно эта сетка вентилей AND, питающая деревья сохранения переноса из прошлого урока. Спека multipliers.t27 вычисляет каждую строку и текущую сумму, которые рисует виджет.

Попробовать

Пройдите 200 x 13 строка за строкой; затем найдите множитель b от 0 до 255, при котором складываются все восемь строк, и такой, при котором складывается одна.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Shift and add: a multiplier is a pile of shifted copies
Shift and add: a multiplier is a pile of shifted copies ↗

Pick two 8-bit numbers and step through the partial products: one shifted copy of a for each 1 bit of b, summed row by row into the product.

specs/fpga/dsp/multipliers.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

Сдвиг и сложение

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/simulator-internals/index.html b/apps/website/public/ru/learn/simulator-internals/index.html index 7232dd3f22..8a18aa8428 100644 --- a/apps/website/public/ru/learn/simulator-internals/index.html +++ b/apps/website/public/ru/learn/simulator-internals/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Внутри симулятора

Вы научитесь

Что симулятор хранит (состояние) и чего не хранит (время между событиями).

Симулятор — это состояние плюс очередь событий, и знание этого делает его вывод заслуживающим доверия. Spec урока, simulator, моделирует сам движок: состояния, точки наблюдения, записи трассы и цикл, разбирающий события по порядку. Виджет читает настоящий стенд так, как симулятор держит состояние: кабели, платы, блокировки и последние прогоны на плате — три прогона x7-board PASS 51840/51840 — одна команда, один снимок, без пересказов между делом.

Попробуйте

Найдите в simulator.t27 цикл, разбирающий события, и скажите, что он сделает, если два события поделят одну метку времени; затем сравните с одним снимком статуса в виджете.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-status · the bench at a glance
tri fpga-status · the bench at a glance ↗

One command reads the bench: CP2102N UART direct on USB (no hub in the path), Digilent JTAG present, openocd not running, lock free, and the last board runs: three x7-board runs PASS 51840/51840.

specs/fpga/simulator.t27

// SPDX-License-Identifier: Apache-2.0
@@ -382,6 +414,7 @@ 

Внутри симулятора

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/skew-and-insertion/index.html b/apps/website/public/ru/learn/skew-and-insertion/index.html index a042bc2da7..c1f68f8d24 100644 --- a/apps/website/public/ru/learn/skew-and-insertion/index.html +++ b/apps/website/public/ru/learn/skew-and-insertion/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Перекос и задержка прохождения

Вы узнаете

Почему тактовый сигнал не доходит до всех триггеров одновременно и чего стоят задержки дерева кристалла 7-й серии.

Тактовый сигнал не приходит ко всем триггерам одновременно: он идёт через дерево, и разброс времён прихода — это перекос, skew. cts.t27 моделирует это дерево с учебными задержками Artix-7 в шапке: BUFH 0,05 нс, BUFG 0,1 нс, джиттер PLL 50 пс и целевой максимум перекоса 100 пс. Запись запускает нативный t27c на ней: проходят 15 тестов, 2 инварианта доказаны comptime. Перекос — не шум, который надо убрать, а бюджет, который надо потратить: сбалансированное дерево тратит его равномерно, и только поэтому вообще возможен один общий фронт.

Попробуйте

В записи найдите две задержки буферов в шапке; затем в окне спеки найдите целевой максимум перекоса и тест, сравнивающий фан-аут буферов.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on cts.t27 -- clock-tree synthesis, native
t27c on cts.t27 -- clock-tree synthesis, native ↗

t27c 0.4.0 on a laptop (macOS): 15 tests of the clock-tree spec pass natively, 2 invariants comptime; the header holds the Artix-7 teaching delays (BUFG 0.1 ns, BUFH 0.05 ns, PLL jitter 50 ps).

specs/fpga/cts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -292,6 +324,7 @@ 

Перекос и задержка прохождения

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/softmax-and-temperature/index.html b/apps/website/public/ru/learn/softmax-and-temperature/index.html index ecd68bd8f4..59e8598529 100644 --- a/apps/website/public/ru/learn/softmax-and-temperature/index.html +++ b/apps/website/public/ru/learn/softmax-and-temperature/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Softmax и температура

Вы узнаете

Как softmax превращает оценки в вероятности с суммой один и что с ними делает температура.

Классификатор заканчивается одной оценкой на класс, и softmax превращает оценки в вероятности: exp каждой оценки, делённая на сумму всех. Оценки 1, 2 и 3 становятся 0.090, 0.245 и 0.665. Если сначала разделить оценки на температуру, меняется уверенность: при 0.5 верхняя оценка забирает 0.867, при 5 все три равны 0.27, 0.33 и 0.40. Языковая модель выбирает следующий токен именно отсюда, и настройка температуры чат-модели это и есть T. Спека softmax.t27 сначала вычитает наибольшую оценку, поэтому exp никогда не переполняется.

Попробовать

Охладите температуру до 0.1 и прочитайте три вероятности; затем сделайте ничью и нагрейте её.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Softmax: how a network turns scores into a choice
Softmax: how a network turns scores into a choice ↗

Move three scores and the temperature: softmax turns them into probabilities that sum to one. Cool it and the top score takes almost everything; heat it and the choice evens out.

specs/ml/activation/softmax.t27

// SPDX-License-Identifier: Apache-2.0
@@ -234,6 +266,7 @@ 

Softmax и температура

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/sort-by-three/index.html b/apps/website/public/ru/learn/sort-by-three/index.html index 183029cecc..7ced7700ad 100644 --- a/apps/website/public/ru/learn/sort-by-three/index.html +++ b/apps/website/public/ru/learn/sort-by-three/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сортировка трёхзначными сравнениями

Вы узнаете

Как сортировка пользуется сравнениями, которые умеют ответить «равно».

Три сравнения сортируют три числа: левую пару, правую пару и снова левую пару. Каждое сравнение сразу отвечает «меньше», «равно» или «больше», поэтому две равные семёрки решаются одним сравнением и никогда не меняются местами. Сортировке с повторами больше не нужна лишняя проверка.

Попробовать

Отсортируйте 7, -2, 7; затем найдите порядок трёх разных чисел, при котором не нужно ни одной перестановки.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Sort three numbers with three-way compares
Sort three numbers with three-way compares ↗

Three compares sort three numbers. Each one answers less, equal or greater in one go, so equal values never need a second test.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Сортировка трёхзначными сравнениями

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/spec-to-verilog/index.html b/apps/website/public/ru/learn/spec-to-verilog/index.html index 2edec81097..65103a8ae5 100644 --- a/apps/website/public/ru/learn/spec-to-verilog/index.html +++ b/apps/website/public/ru/learn/spec-to-verilog/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

От спеки к Verilog

Вы узнаете

Как функция t27 становится логикой, а тактируемая функция — регистрами.

Verilog — это текст, по которому синтезатор строит схему. t27c пишет его из спеки. Функция с именем on_clock становится блоком always по фронту такта, а каждая переменная модуля — регистром со сбросом. Откройте clocked_counter.t27 в плеере: 8-битный счётчик в несколько строк и Verilog, в который он превращается. В его заголовке записано, что из него построил yosys.

Попробуйте

Откройте clocked_counter.t27 в плеере и найдите блок always на вкладке Verilog.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

hello_world.t27 to Verilog, in a terminal inside the post
hello_world.t27 to Verilog, in a terminal inside the post ↗

A terminal in your browser running the t27 compiler as WebAssembly: t27c gen verilog prints the Verilog it emits for hello_world.t27, and t27c test runs the spec's tests.

specs/ternary/clocked_counter.t27

module ClockedCounter;
@@ -105,6 +137,7 @@ 

От спеки к Verilog

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/stages-of-t27c/index.html b/apps/website/public/ru/learn/stages-of-t27c/index.html index 128c625281..c33044d36d 100644 --- a/apps/website/public/ru/learn/stages-of-t27c/index.html +++ b/apps/website/public/ru/learn/stages-of-t27c/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Стадии t27c

Вы узнаете

Порядок стадий компилятора и что каждая выдала для спеки урока.

Лексер режет текст на токены. Парсер строит дерево узлов. Проверка типов сообщает об ошибках и предупреждениях, не останавливая бэкенды. HIR — аппаратное представление, из которого пишется бэкенд verilog_hir; остальные бэкенды читают дерево парсера. Таблица показывает, что выдала каждая стадия для спеки урока, по замеру компилятором этого сайта.

Попробуйте

Откройте виджет стадий t27c, вставьте спеку урока и сверьте числа с таблицей.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 23: the stages of t27c, counted
t27 basics 23: the stages of t27c, counted ↗

What each stage of the t27c compiler produced for one small spec: bytes, tokens, tree, type check, HIR and backends. Lesson 23 of the t27 basics course.

specs/basics/23_stages_of_t27c.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

Стадии t27c

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/state-machines/index.html b/apps/website/public/ru/learn/state-machines/index.html index 8359489f85..4ff95dc1ca 100644 --- a/apps/website/public/ru/learn/state-machines/index.html +++ b/apps/website/public/ru/learn/state-machines/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Конечные автоматы

Вы узнаете

Как синтезатор находит в дизайне конечный автомат — или отказывается.

Многие дизайны — конечные автоматы: регистр хранит текущее состояние, а логика выбирает следующее. yosys ищет их и, найдя, может перекодировать. Когда он отказывается, он говорит почему. Виджет рисует граф, который yosys извлёк из настоящих дизайнов, приёмника UART и мастера SPI flash, и показывает случай, где он отказался.

Попробуйте

Откройте пример uart_rx и посчитайте его состояния и переходы. Порт JTAG тоже работает как конечный автомат: найдите в спеке тест, который говорит, сколько состояний у контроллера TAP.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

FSM sketch: the state machine yosys found in your RTL
FSM sketch: the state machine yosys found in your RTL ↗

Drop a yosys fsm_export KISS2 file or paste the fsm_info log: the state diagram yosys extracted, its states, transitions and inputs, and the registers it refused.

specs/fpga/dft.t27

// SPDX-License-Identifier: Apache-2.0
@@ -331,6 +363,7 @@ 

Конечные автоматы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/status-and-fifos/index.html b/apps/website/public/ru/learn/status-and-fifos/index.html index 60676475a9..9a6af7985e 100644 --- a/apps/website/public/ru/learn/status-and-fifos/index.html +++ b/apps/website/public/ru/learn/status-and-fifos/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Статус и FIFO

Вы узнаете

Что опрашивает драйвер, когда отправка отвергается и что проверяет тестбенч UART.

Драйверу нужно знать настроение железа: спека несёт STATUS_IDLE как 0, STATUS_TX_BUSY как 1, STATUS_RX_BUSY как 2 и FIFO глубиной 16 в каждую сторону. Тест uart_tx_send_returns_false_when_busy — правило, по которому живёт драйвер: нельзя толкать занятый передатчик. Запись опускает тестбенч-спеку UART в Verilog: как выглядит стенд, когда его порождает компилятор.

Попробовать

В записи найдите, что стенд печатает о линиях в покое; затем в спеке найдите три кода статуса и тест, отвергающий отправку в занятости.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on uart_tb.t27 -- the testbench as RTL
t27c gen-verilog on uart_tb.t27 -- the testbench as RTL ↗

The UART testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.

specs/fpga/testbench/uart_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -464,6 +496,7 @@ 

Статус и FIFO

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/stop-and-mute/index.html b/apps/website/public/ru/learn/stop-and-mute/index.html index 923061de21..2a75355dc0 100644 --- a/apps/website/public/ru/learn/stop-and-mute/index.html +++ b/apps/website/public/ru/learn/stop-and-mute/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Stop и mute

Вы узнаете

Что делают /stop и /mute и почему ни один не теряет человека или прямой вызов.

cooled говорит, прошло ли 5000 мс с последнего сообщения бота. /stop глушит разговоры ботов между собой в чате на STOP_WINDOW_MS, 10 минут, а человека по-прежнему слышно: это may_answer_after_stop. /mute заставляет агента молчать в теме MUTE_MS, час, но на свой тег он отвечает: heard_while_muted. Оба — часы, поэтому никому не нужно включать улей обратно.

Попробовать

Протяните часы /stop дальше 10 минут; затем позовите тегом заглушённого агента.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The cooldown clock, /stop and /mute
The cooldown clock, /stop and /mute ↗

One agent answers another at most every 5 s. /stop silences bot-to-bot turns for 10 minutes and /mute an agent for an hour. Drag the clocks: a person is always heard.

specs/automation/agent-hive-group.t27

// SPDX-License-Identifier: Apache-2.0
@@ -429,6 +461,7 @@ 

Stop и mute

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/strobes-and-waits/index.html b/apps/website/public/ru/learn/strobes-and-waits/index.html index 5ca1a8d8b3..e2a5600b8d 100644 --- a/apps/website/public/ru/learn/strobes-and-waits/index.html +++ b/apps/website/public/ru/learn/strobes-and-waits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Строобы и ожидания

Вы узнаете

Что значат байты строоба, когда слуга держит шину и как это видит IR.

Байты строоба говорят, какие линии слова несут данные: strb_width_32bit и strb_width_16bit — два из восемнадцати тестов спеки, одно слово подаётся целиком, одно полсловом. Медленный слуга держит шину состоянием ожидания вместо догадки. Запись показывает мост APB как аппаратный IR: PSEL, PENABLE и дешифрацию в той структуре, которую даёт компилятор.

Попробовать

В записи найдите PSEL и PENABLE в IR; затем в спеке найдите два теста ширины строоба и скажите, что стробирует пересылка полслова.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c debug-hir on apb_bridge.t27 -- the handshake as IR
t27c debug-hir on apb_bridge.t27 -- the handshake as IR ↗

The APB bridge spec lowered to hardware IR: PSEL, PENABLE and the decode as the compiler structures them.

specs/fpga/apb_bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -415,6 +447,7 @@ 

Строобы и ожидания

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/structs/index.html b/apps/website/public/ru/learn/structs/index.html index 13e9ed5a52..a66e0b1a25 100644 --- a/apps/website/public/ru/learn/structs/index.html +++ b/apps/website/public/ru/learn/structs/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Структуры

Вы узнаете

Как объявить struct и packed struct и сколько их может быть в модуле.

pub struct Point { x: i32, y: i32 } объявляет тип с двумя полями. Поле — это имя и тип, поля разделяются запятыми. packed struct кладёт поля вплотную, без выравнивания, как устроен аппаратный регистр. В модуле может быть несколько структур; в спеке урока их две, и вердикт чист на всех 7 бэкендах.

Попробуйте

Добавьте в Point поле z: i32 и проверьте, какие бэкенды его по-прежнему компилируют.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 17: a struct and its fields
t27 basics 17: a struct and its fields ↗

A t27 struct and a packed struct drawn as tables of fields, with how many backends compiled them. Lesson 17 of the t27 basics course.

specs/basics/17_structs.t27

// SPDX-License-Identifier: Apache-2.0
@@ -89,6 +121,7 @@ 

Структуры

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/sum-and-carry/index.html b/apps/website/public/ru/learn/sum-and-carry/index.html index a67165e0dd..aff4a0a008 100644 --- a/apps/website/public/ru/learn/sum-and-carry/index.html +++ b/apps/website/public/ru/learn/sum-and-carry/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сумма и перенос

Вы узнаете

Как сложение двух тритов распадается на таблицу суммы и таблицу переноса.

Два трита в сумме дают число от -2 до +2. В сбалансированной троичной записи это трит суммы плюс трижды трит переноса: +1 + +1 = 2 = 3 - 1, перенос +1, сумма -1. Виджет показывает оба как вентили. Если считать таблицы, у двухвходового троичного вентиля 3^9 = 19683 вариантов против 16 в двоичной. Спека урока собирает XOR из троичных нейронов: аппаратная сторона той же идеи.

Попробовать

Найдите две пары входов, у которых перенос не равен 0, и проверьте для каждой a + b = sum + 3 x carry.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Sum and carry: addition as two gates
Sum and carry: addition as two gates ↗

The sum trit and the carry trit of a + b are two 3 x 3 tables. There are 19,683 such two-input gates in ternary and 16 in binary.

specs/ternary/ternary_xor.t27

module TernaryXor;
@@ -146,6 +178,7 @@ 

Сумма и перенос

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/surviving-mutants/index.html b/apps/website/public/ru/learn/surviving-mutants/index.html index 3ad8dac54c..8961b9251d 100644 --- a/apps/website/public/ru/learn/surviving-mutants/index.html +++ b/apps/website/public/ru/learn/surviving-mutants/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Выжившие мутанты

Вы научитесь

Что выживший мутант говорит о тесте, который его пропустил.

Выживший мутант — самый конкретный баг-репорт из возможных: вот неисправность, вот тест, который должен был её поймать, вот почему не поймал. Виджет посчитал их там, где никто не смотрел: 367 PR пришли в t27 за 14 дней, и 11 из них удалили тесты или ассерты; один PR с названием под реализацию удалил все 26 тестов в своём файле — и ничего не упало. Каждое из этих 11 — мутант, который выжил, и выжил он потому, что человек его пропустил, а это ровно тот класс отказов, для которого мутационное тестирование и существует.

Попробуйте

Откройте виджет test-touch и найдите PR, удаливший все 26 тестов; затем скажите, какая проверка поймала бы его на ревью.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Did the agent touch its own tests? Every PR merged on t27, checked
Did the agent touch its own tests? Every PR merged on t27, checked ↗

Every pull request merged on gHashTag/t27 in 14 days, bee lane and human lane: which added tests, changed them or removed asserts, with the exact test lines from git.

specs/tools/trios/tri/x7-mutate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Выжившие мутанты

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/swish-and-silu/index.html b/apps/website/public/ru/learn/swish-and-silu/index.html index 879b8c76d1..f94aa7f40f 100644 --- a/apps/website/public/ru/learn/swish-and-silu/index.html +++ b/apps/website/public/ru/learn/swish-and-silu/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Swish и SiLU

Вы узнаете

Как x, умноженный на sigmoid(beta x), открывает сам себя и как один параметр переводит его от гладкой кривой к ReLU.

Swish это x, умноженный на sigmoid(beta x): нейрон, который сам себе вентиль. При beta 1 он называется SiLU, и его нижняя точка -0.2785 около x = -1.28. Увеличьте beta, и вентиль становится резче: при beta 8 кривая это ReLU со скруглёнными углами, при beta 0.5 пологий склон через ноль. Один параметр переводит нейрон от гладкой кривой к переключателю, и сеть может его выучить. Спека silu_swish_activation.t27 вычисляет кривую и её наклон при любом beta, а также свой пакет при -2, 0 и 2: -0.238, 0 и 1.762.

Попробовать

Держите x на -1.28 и поднимайте beta от 1 до 8; затем найдите beta, при котором провал на этом масштабе исчезает.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Swish: one knob between a smooth curve and ReLU
Swish: one knob between a smooth curve and ReLU ↗

Drag along x times sigmoid(beta x). At beta 1 it is SiLU, with its dip of -0.28; turn beta up and the curve closes on ReLU, turn it down and it flattens toward x / 2.

specs/ml/activation/silu_swish_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -203,6 +235,7 @@ 

Swish и SiLU

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/sync-or-async/index.html b/apps/website/public/ru/learn/sync-or-async/index.html index ffbfbccc4e..4df6765034 100644 --- a/apps/website/public/ru/learn/sync-or-async/index.html +++ b/apps/website/public/ru/learn/sync-or-async/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Синхронный или асинхронный

Вы узнаете

Три вида сброса, какой из них гонится с клоком и какую форму рекомендует курс.

Плата нажимает сброс, когда хочет, а не когда скажет ваш клок: ассерт может быть асинхронным. Снятие — не может. reset_sync.t27, написанная для этого курса, называет три вида: sync (0), где ассерт и снятие идут через клок; async assert, sync release (1), обычный выбор; и async assert, async release (2), который гонится с recovery и removal на каждом триггере, что он питает. is_recommended() принимает виды 0 и 1 минимум с 2 ступенями. Запись запускает нативный t27c: проходят 16 тестов, 3 инварианта comptime.

Попробуйте

В записи найдите тест, называющий асинхронное снятие гонкой; затем в окне спеки прочитайте is_recommended() и проверьте, что она требует от вида и числа ступеней.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on reset_sync.t27 -- the reset kinds, native
t27c on reset_sync.t27 -- the reset kinds, native ↗

t27c 0.4.0 on a laptop (macOS): 16 tests pass natively -- async assert with sync release through 2 to 4 flops, the racy async release, and what validate accepts.

specs/fpga/reset_sync.t27

// SPDX-License-Identifier: Apache-2.0
@@ -327,6 +359,7 @@ 

Синхронный или асинхронный

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/synthesis-warnings/index.html b/apps/website/public/ru/learn/synthesis-warnings/index.html index 7b74910e81..505555ef19 100644 --- a/apps/website/public/ru/learn/synthesis-warnings/index.html +++ b/apps/website/public/ru/learn/synthesis-warnings/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Важные предупреждения синтеза

Вы узнаете

Как читать лог yosys и какие предупреждения становятся ошибками на кремнии.

yosys сообщает много, и почти всё это нормально. Несколько строк — нет: защёлка, которую вы не задумывали, провод, который никто не ведёт, два драйвера на одной цепи, память, ставшая триггерами. Всё это работает в симуляции и ломается на чипе. Откройте один из настоящих логов спек t27, затем вставьте свой.

Попробуйте

Откройте каждый настоящий лог и найдите тот, который yosys отверг, и почему. В спеке проход по модулям считает, что он вычистил: найдите три счётчика CrossOptPass и тест, где они в сумме дают 17.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Synth smells: a lint card for your yosys log
Synth smells: a lint card for your yosys log ↗

Paste or drop a yosys synth_xilinx log: latches, undriven wires, driver conflicts, memories turned into flip-flops, warnings and final cell counts, read in your browser.

specs/fpga/crossopt.t27

// SPDX-License-Identifier: Apache-2.0
@@ -193,6 +225,7 @@ 

Важные предупреждения синтеза

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/t27-number-format/index.html b/apps/website/public/ru/learn/t27-number-format/index.html index 842ad09f37..057b3f8547 100644 --- a/apps/website/public/ru/learn/t27-number-format/index.html +++ b/apps/website/public/ru/learn/t27-number-format/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

T27: наш собственный формат чисел

Вы узнаете

Как три трита дают больше уровней, чем 4-битное число с плавающей точкой, и чего это стоит в обычных битах.

У 4-битного числа с плавающей точкой вроде E2M1 — элемента форматов NVFP4 и MXFP4 — 16 кодов, и два из них означают ноль. У трёх сбалансированных тритов 3 x 3 x 3 = 27 состояний. T27 — наш формат, который использует их все: 27 уровней стоят там, где на самом деле лежат веса обученной сети, и один общий масштаб на блок весов. На троичной памяти это больше уровней в том же объёме. Упакованный в обычные двоичные биты, он получается больше, а не меньше, и виджет показывает оба счёта.

Попробуйте

Проведите вес по всему диапазону и найдите, где E2M1 округляет хуже, чем T27; затем прочитайте таблицу хранения в битах. В спеке tnf8 тратит три трита на порядок числа: найдите тест, который считает его значения, и смещение, которое он резервирует.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

T27 cell: 27 seats in 3 trits against FP4's 16 codes in 4 bits
T27 cell: 27 seats in 3 trits against FP4's 16 codes in 4 bits ↗

Drag a weight along one line and see where a 27-level T27 cell and a 4-bit E2M1 code round it, and what 32 weights cost in trits and in bits. Numbers from two compiled .t27 specs.

specs/numeric/tnf8.t27

// SPDX-License-Identifier: Apache-2.0
@@ -110,6 +142,7 @@ 

T27: наш собственный формат чисел

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/t27c-on-a-real-machine/index.html b/apps/website/public/ru/learn/t27c-on-a-real-machine/index.html index fa7a73feec..cd2017ee6d 100644 --- a/apps/website/public/ru/learn/t27c-on-a-real-machine/index.html +++ b/apps/website/public/ru/learn/t27c-on-a-real-machine/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

t27c на настоящей машине

Вы узнаете

Тот же компилятор на настоящей машине, печатающий то, что он действительно печатает.

Плеер в уроке 7 запускает компилятор в вашем браузере. Эта запись — нативный t27c, написанный на Rust, запущенный на настоящей машине на том же hello_world.t27: он сообщает статус спеки, тесты и инварианты, которые выпускает, и модуль Verilog с параметрами. Каждый байт записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите строку, где t27c печатает параметры модуля Verilog.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on hello_world.t27
t27c on hello_world.t27 ↗

t27c 0.4.0 on specs/demos/hello_world.t27: spec-status IMPLEMENTED, the two tests and two invariants the Zig backend emits, and the Verilog module with its parameters.

specs/demos/hello_world.t27

// SPDX-License-Identifier: Apache-2.0
@@ -169,6 +201,7 @@ 

t27c на настоящей машине

}

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/tables-and-interpolation/index.html b/apps/website/public/ru/learn/tables-and-interpolation/index.html index 06ba56d713..a0fffd788a 100644 --- a/apps/website/public/ru/learn/tables-and-interpolation/index.html +++ b/apps/website/public/ru/learn/tables-and-interpolation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Таблицы и интерполяция

Вы узнаете

Сколько записей нужно таблице синуса и когда линейная интерполяция выгоднее лишних записей.

Таблица четверти волны из n записей отвечает с точностью около половины шага между ними; интерполяция между двумя записями снижает это до h^2/8, где h — это pi/2, делённое на n. При 16 записях по 16 бит ближайшая запись ошибается до 0.049, а интерполированный ответ — до 0.0012. Начиная с какого-то места, новые записи ничего не дают, потому что сами b-битные слова ошибаются до 1/(2S). Спека cordic.t27 строит таблицу и меряет её своим же CORDIC на 50 шагов.

Попробовать

Сравните 16 записей с интерполяцией и без; затем задайте 256 записей и найдите ширину слова, при которой ошибку ограничивают слова, а не записи.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Sine tables: entries, word width, and interpolation
Sine tables: entries, word width, and interpolation ↗

Choose how many entries per quarter wave and how many bits each holds, with or without interpolation, and watch the worst error move between the two bounds.

specs/fpga/dsp/cordic.t27

// SPDX-License-Identifier: Apache-2.0
@@ -437,6 +469,7 @@ 

Таблицы и интерполяция

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/tanh-and-saturation/index.html b/apps/website/public/ru/learn/tanh-and-saturation/index.html index f3d83594ee..c8fc02fab1 100644 --- a/apps/website/public/ru/learn/tanh-and-saturation/index.html +++ b/apps/website/public/ru/learn/tanh-and-saturation/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

tanh и насыщение

Вы узнаете

Почему tanh центрирована на нуле и где её наклон падает так низко, что нейрон перестаёт учиться.

tanh это сигмоида, растянутая на -1..1 и центрированная на 0, поэтому слой нейронов tanh передаёт дальше значения со средним около нуля, а её наклон в центре достигает 1. Она тоже насыщается: при 2.5 выход 0.9866, а наклон всего 0.0266. Красная полоса отмечает все входы, где наклон меньше 0.1, дальше примерно 1.8 в обе стороны, и нейрон, чьи входы живут там, почти не учится. Спека tanh_activation.t27 вычисляет кривую, наклон и свой пакет, tanh от 0, 1 и 2: 0, 0.762 и 0.964.

Попробовать

Тяните x, пока не начнётся полоса, и прочитайте наклон там; затем сравните наклон в 0 и при 2.5.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tanh: where a neuron stops learning
tanh: where a neuron stops learning ↗

Drag along tanh: it is centred on zero, and where it flattens out its slope drops under 0.1. The red band shows every input where the gradient has all but stopped.

specs/ml/activation/tanh_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -164,6 +196,7 @@ 

tanh и насыщение

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/ternary-computing/all/card.png b/apps/website/public/ru/learn/ternary-computing/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..2bf24b9b928bb6761a964a5564957093fddd3ecb GIT binary patch literal 45064 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�e6`QwV<@aSt zaEKJ-qat{T+fVnnenA;_Ue_%o-kOSbiH%5hG+u-@6J?R9>FTNJFtIo{>{<+t(F6|6 zjTj9%Z10b_oTf6n5dLtu`B*uP$g<;_xB8gF!sabr`BxBC~{G$H0v@#ryk) z7Gf+M2?%E46&=C0oLd1VY2MS8j!cfnS3~fxDF#Q(2)pg%=osZ=SeQnS!0SnK+200D87z<%5>aT<^FlS{G@~-BNFQ#Q37et1H57K`ci)Alx z?2qzrwOO3kZPxW&E^5yfHrghR;xD-S2RY}}WH|2`-OOwphfEDBr6;}<8M9{JLN@=W z?=@T2{PrsEQNa{+b@PX*ylT_36^6X3fMb$S%I|~EKRb8BNw?~GPJ#2y)X}g+|KKxv zKexSv&+C0b{ZWT!bBC*5cH(}a*Ph~sG**uEut^ru)tkDRkmgGhbF^^cJh#tudBOI9 zZQ>)v3m9bQe zOIF?FHc>rUHy*1e!CkQ&r;ciB#rAU{X;i&Q_LkE58%y7^w^RZ-;_g!hRd*@o@J7Cd z+BL7!JQ>G)O<9CmzAQ$=Ww8^}&hCgmx;`K1MPO zhIDAvi7A8V6pyA}C=ci*E`!w%%u+QWe`T%-GstC7md z*v4+<6Te0|vI&!ts^smY4~1`J<8o?ucC44psVEdgjE#SmlXn-BDdgbf0CnGLuMFGQ z^OWYA&}zv0t+W#yWwr21j4&Z_r)+0qcupmyftxn%CWQre`_d`cK;eVwZJirw_~S)u z0c_VK3)+T5v#7mTM@D;fwTt!g1)7%FT4RZ)A9OaFN28{R(qWZ-ugCBAVN2m(Z4Bxu zmIZ@S)d{00TD{wwroPMlZY0DbL3kISy5r?I8QbKjHRyZawcG|IVp_#ajFkrQ66&Jj z-(15=iB2xxJG!Aa8fYZ^n5?(s_eiy9u&v1Z_z{Dqg(>eR`zTQkbsT3%8s4PToqhLe*}3#(;(48giJs?CyW*uEUz{SvFuw zFl_2^HLBi!kICZCK_Z}4`X0OR4W;?>cN+ne&5AQEa@#SH3alj1gSo`|e!W%bwgQK& z%{Jrcbq{e07g;~w(IAzcy33T$xq@RkKJ4l2@{uc{g%T%x(~?ebs#d$&iDxpsqCa6- zfI3OYJPqI7xKcwxh){m=a86ZaQOWHy)rS)5H=RTzID}k3YwT$kak11UdR}60-KYK* z;-b#|t(9EgJfXGfq&k|;=?c>M*4EJ3fsW&;#9v3-DF*v}m3&rr8;Os+YVtbcx z`IbYaMh6H+#sQ%y4B}!8Au^*P?A{)8Ta>}tU_8aTdF=VgcfJFq1Kc;q`}T8pBxRps zYW+~jf>REAl&kG+VImw#a;AVHb{rz0br(zIHztdvqobW-!uvytrY z#fyaxY2{xzsf zGdk~D4L80ubsQJr5GN@vCl@5qkwHYY%0^PQzq!VzDd!#i+*pnt+BUfeS5yS^>#2Z% zg*<#a6EX1aPBp5nvqUCPy(sDZ~q31PlJ9zLBc*FQ(9cf5Ym^YV32c(1Q3Sx1RQ#bUk5g|QfqLzpLz}NY28NaX1W5~sS_Lk<+)|o<|9fa*M*TE8P=oB-1C*hlgI43#vPN?$Dkq>?}}Os^zYaSHrk<$(u5porYhQ zXVNcb16H&D0{22rviC9m9O2H-CHCRos&VKa#D#X)0!z!nu1h{&&cJPu%?X8W*V(!g zYz?DXPpw~;$-9?Nd#!9i0}yI}{eP#bTjkpx5}~VJ1YtYG?aqv1mwLT9?QAg^8BdlQcOPn+2Y_(Hk{^B_+rfstZ zlPpIc%`A$_23eB!#o+PP2v2`SLveL+L&fcL%tr6@Jqjw^6$QPEx??fMRfYlFm(#Q6 zY>RaZdczgY7La)-wocUj0~>>o>X{XrL<`a%4dN>4t-Vy%jwR@q-i4S7j^(&J~jkxcX3s1710P9IQRu~bPEjXvqma|4rPmYCL>AF zMZWrs#*xxZ>YM3pht3mQhBAHFKc_VhC$fyM_|%M)XW^#f_&s46S~J198<<3cY0fpf zqL)_0y9s4#HifPhDanZ})S$0gXX(RmlIU}@1< z)j?Kg1cjcJ4PS)~KXw$aypihevuy}NL4MJ!WnHPVT%@(@8a@GzU)I{U6huTt@cl;i znA~s_AAJmSw>b5{=ss+f#A9txBr35wqS=aPRJgy&q@DM?JgeZzZ~vGf{)@G`p7bso z7Xi}SW(}kooL6;5K@KBlH5oJUjd0(yV6H!9@8YEUngWm-(@Nrg5#c)Q8-<7O$nc z?x%>8l&Kpvvrm;}imsmV2q*7@I{QzJR|)g!!fyqlF_Fo$h|ZP!Z;Cv$-nPW7$Kfx{ zZVMvhQd7HV2YsSnfrQfeJIJUG-sfCYq9(C4bCaqGd`j4=Yv&8lol@{F6#CX zGb*~KWg z`!-{Ez^zToU}*A?iY|G!QM#cymZQ8&Dk+opg??imTr#K3)8kjzV>z%<{eAc1%W(H|&=2wl z$dmu@SUl}%ZIj5EbUFH{5ZNX7rR=-0x%hhd{GiskgCjeA=To&<^m3)QC3meXUbE(D z_w~I`bG&lCu3#wUEMMs2)-JPy4G9M?vh=@7Iez8sMzzhH&@x#o#vFo#7MhClC&z&l zejL~VU&DXqW1}^m zlF~mVHjFua88etKrJF6df`hImxD^}!LLu9>sZetA%-`d+CL1*$g zd)+&pPjFw%Ru0tEAn5A&OyWl?*?Wfq`QEH?BC5u2Yj}D>oJ(E#Pfu-CXPZy|iJNn) z%h3C2svGi52N052qT3^DUXt^4&Lf_}nbF-f-D$*Ts+zYhWp@3`>6!ys>czJb*F0YD z@?%HKrBE+@+@#PMAr3y=Q^r}w(thHtL4!NoxI?<2{OVGKDMK)JK(QpmVL=kQYbl?t zByeGFUE?Lxq+g1A?mnpY?5u$ zIJ3hn*D;AzE}5c?6~pJ|9bJLj5BcX9L2^GT;brDOXC9!6P`#9uW8>DA|J|>3$C@D6 z+H|_{2^C4@(J*Qq$w^O33s>hH40!XLI}7Drbv7hKD)X=ibDi@%(r;`GY`ij*FE}ar z9Ss>hNwTamEKm1#opv}s!$w$oDuk!(Ivd$(l1r+1f0DH@gDO~ien=~72*KdvF&Xs{ z(y7!opyZpL+s%_S7H)nUWIt4y<*_ z(MXWEaR%npN|TcG;ZrM~xm>uNOUb5w@bDLNmFu@pBuP)0eD)!GJV_*l>3W{s_c@>V zCB)C?G34$$cPmG<>Sv`OmHQ{8fk>(S>~oi+n_3vr#6A7Hl3QU&-|+KC7hmP}E{CJL zJn5WRn!&trlA_ItD9f7+y*5mR2xGe}pc^RK6>y59rgn|8ADDKwQU%byEz%Rwrsuo< zHYNPN)O!tB3t=pSXG3(_g3Q;S4r-0We71q*2~z4U->+Q5_qlelW1(;BS@^I^l!?!5 zDGe{u=o|ILT3Se4r;SY*2c7tTol$%&2pem{aEI|nf2-M@y929OUg5n!?h-?ECrKmq z2JcZC=Y+jwcG8pz5Mz3JJKYUKe!D-bX8+AmrR$m)q()Y!#~V_iPLkHwg}&d&D7pP$ zTUa;64LAEBZnj}LIJrTn%S`5`nC?LXw)J|e5No%i3Eq{=8=J0&$nq6fb!h*^@~yAY zZuHTX;fd5zWp??xq7Uu=``;T4?t>xSxuI`Z^qYwMvgm@E$%3sLq{O37(5x>$Ly42yH z!Yf3@EL7b3kE3~?l=lf9H7jz?xL>86q=h)$SaQ<_sx_}$i1_iU$Fim+nIiLhV-tI( z+HVqzoXEPhX9nf(qocGHT@I)9Oly2RDWw%huSQVjovk$qQnm$a@S z@h4TA<;OlS+Ij=$tu+vhKy8eZvy@lp#Yh?mw?TFX2r@T~=W10t!$2eG3!QZ7UiH9c#@IU*|5Uu3NoJ^RLNFqht z^~C7S!nsLajj4q*2jh-i3q8%?!%N}}&~;{bWXCB9j~`PTlqKfC>FUOdA?|iBkcoO> zQ_j*?kK&?lV%!#8+Bkzgz&Z zYLmZoCv5?(qFhuYFGNpj-0b!avNw_Jv&0>|j3OAvB*>tWlQa7}da0e>V>`*x%-qvj zL2t)%j_&u2{Xunb(PAvwz?aw0PVg#ksHo^Tcvu+qC|+g2VjVE7{|FzR4AruJ?557( z5A(0F)mJL7a42-D;Zx?wj@_62?rf})p@%y@tBv?wUejF|^9l9IQe+}wUClc|_f6NL zkHN7%{esWRT=Tu&&ascV@SB6W@d=xpG0q0-ipnN-zHTbJ zt(`5(cDJdvmD!`B9i8ikcjQu4XI>LyZ^C3{6y>8h*h6HwtP-^C z7`7vYOsow5$1J)(k$GD&By z>PuNoy@H9h8eHKoOc`&?FNZGXKNW0-W)Xm1G(>`@ zwe|Sn|5jRzP&$euoZ_m>NO#}k?JR&0>*Q+DVG$!X3rFAE^{7r}p03~KO;>e+>)^uX zTr&=qvRuqQL2A5)`|KB6T7(WO@k?AAIK+`Ug=b-1=P$o_t8ls>$T&)p(0;br7QgnTsnwIk(rW-IXwWa(=) zswTTOc5cD1?Ph)|zl(LJZ@C9h^Ym9l6lmo^e4Zg zEqbQ93a1v;`p@dWsz{kdx?(9NW>z=mDn5T6rS(JmI9>lx0%a*D)_rZ>%#kIpnYV2H zxgZ)xr^Kb_hO8BLQ}YzlOVo7Q#uDw)ev{|iSW!x;IP^Xq!=4^{L^;{A+ow|Y-H<`W zghYJgF2=cL^@S0ntgLRIrANQnho4WRB-3$S+hhd-bqWnM)VDlSVY%pJFy7mDAC8jj zkEZFztR#bQO1rClTKe=qaJTGDKvWz&oySdXxRg@E@n;HUmF(S~{6LAnWVCdzOOYn`KR%M)P#SS= z&vR0~-f7Pf)Cl`N|B;T5)W*yW0JqcxH^=c5(*`BMA^7{Q1na6K9VCV}g-tYjXGitX z$Ff?D1CDEKxvQ_OX;TY($T7_9Ug5roJsCk*8S^$=F%e za=b}7ao%dY8V>KVoAzBX2cm}h5>*4ZLkbz{+^8ESom=_Z@0ifN$F`n2T@YB@{&CR~ zysQ+>>7Xbi&hY$~qcOxPd*OeMaLC`#`Oc1S!WS< zZL5}Qsm&G)^bnnsA7539^Dqno%_DiESmQ_^H~RvhAnQVJTJW<#eP{G$b(?qm$Th}6 zb@H|cqDQgc#WEdrSQND0BBN*`BKX$7kRR-ze9WWm)GE`wqxQrZR#iUR(x9|gFVwu! z!tb%jzuD5sJY`>nmo)c;SaNE(Er={C+GLl+MVx9|NPMc6OR1#aW^>bZ3Q`LnV*D#u zS$cj_S7_3_!fvoJ8ndYopn^DxD#JawFla#=8pcrMdm|i}{;zovg4CJ~8xHvJpT;X} z2=xkXTjNM^TbFV7p1H4G4IW7X(R98`Ia-8lWW-CpkX=KAQ4MX?zIE|P=OW9aTuBo3 zV`^p5i?z5E+_u?Ne#ThRh*;;nAsi*q@gc2xJP|i{E6Qn1Uug%u7vc(XB%<^_Hbp+7 z&k+2wr|aBOC!QWpI7C~1_NxvJTi~Q%v%y*3bEO##VcHm}>QUb;z?m@I|5oqi7Noe9 zrCQnYKh3`S#f@`&8wneIYwu6lpn}LxpOSoIZ!SkQmmZ+F|4fG@m}sDAZ;Rw$F?%ss zQAT;w(s+I_ih5H()zoAYd(TM*XuaNZ1EEzv@`;sX%^VK3uHko87W)+q#Pg?%L$8n! zHeW`O`4|O-7)SmvgS{`So4oR|11xz_a{i}{1r)}~v{r{p2UwS8T6WXcO^cZ zCKf5^?rT^WVnS`4I=}L(-j=mz$E`L*zE_kDZswg3sA{RDORiTC``D=R?*?(U3W^_qLoTgQq;}J_sRH=`yl6*U2!N zx*g4L6s1=+q>xLb-{}VI-4Pxeyy7w#TK~!1&xbO8^OG?4-dQrNqhMdIe_{QLzhsb0 zhN@!6Am0Ib@4Qw0$$o<%4z&k8dPHC#R7Mchg*vj6a0~Q+1L%OZzPGZ8RWv*2tMv?D4#Zwbcx3akpJy=+l zo)pVjZ_aiSSK#>Kge;?-&v!K>f!oR<7UolVIEecRlt?Ky?p>OWwq4`fiT&6~FEsl% zu4ah)h|T0IEss4f{6<2eG81dL0})B;k4=)M9j8^mR-CiEyjr~AvQSF<`+13rHy>-- z>2uk1IRjbDNbQ50=WISrzl@RJ%zuaHP^_F~XY6KGl$ZO&{u<`{rz`nlL0^OKjXi-V ztaP)2ZxT;G+_ur&=JT7ZkONubZA%e70^jEr#){&3+}an#ny>7~i+&Bl7J8z=9Uf5O zWj|(`F$xsd~>Xe`w{p^`LR0h?#0TNE`~hCWr?y;rK^5Y`+t}Tc-h=EHeX6#hi#llJ~J761jR%XxKs&VF&{8ZR%eDt((Vu@a@Cz<^%v1Y>4*lqfS} zCE9`XHNF9fEJad=KueyV;vA>P_B_L;h@bn%z-GuVv8zSea$yA;q?6^vSMDumh0hxJCAP06nNKFpr;1VvFnwgp8$kj6Pb z|6od;bVzO2)R0OQZU$KFP*6*Mh3Rs|YiMm&Wt z_&5;tUn1aSTJjD?&bzW(#mv16-v{;HF-uW!nIXCCLr6Rh7SeXNF=ot{YE8)EYn`NO zL3Ta0o%VnU~M43p#MhH6}zdfxe|@QAl%Z{q$eov`j7G@5poK}CG=|M;Eb z&-`<~8EaSb7tpyvu!Re_-?uzYnk_pmacFg6G3(HtMjwQSxHxV z;=$@fxYejTPsolwoN2dg&UdJ8Xz@B6H%F}3F|SYo5`79Im*G}NT8 zw3vvEq}Y?2r3fvZVpeB$DyjL5;hCp*lhD;7PHW!ali_pHRjvi`UtZRYV&%kUrc>~v zq3~OS2xd1F{m*>bgqJ%kJs~&v9K@quT){U7qZV)`7Sbu(s;W3D%njZCfog^?yJIzx z-;IET7*E)f{9lF*y$(yDB=7XWP&Ld$=^s(Zox9{!U2-H5Vll09qZ4}0;du~G`k>P4 zQdbRtt7Ddn+Jbc5%$vRiuWO}2irgyO5E1*vgX z>nfHdZu2N(85qP^vrnJ$DS5*~Ylh5?n!(za&J0UEjC%2SGRu@`ta(eKg5?Se?uGHe>`5M7NmDc8#UU~O&{NPC? zJC6V-t*fS-rK=e=?ySoiQryJkhkk3s*TI`R{{O4J>+EW3Yqy*uAjKd^I|L8`K|_-k zkg5=h2%!Z;AfOmpfPfGXB_b9;dat1gk%)BZMc`1R2%&@;s-Om>O0UY@@Vp1Y_TU|Uc_6!DSmF$0kP=CD?{1^cb&Ap69$Gup&-waZumL*e@+pZZfoo6(%JTMT-n1Oo_m&dj=rX%&S zR^AaB0xp?Ni(P1Fz2bKcI&7!ZvEnq4kFq=70ZnY_JAP{GvD$tBzL9>b+mY z7c>cuDve#lf!nXwv=lR|zrZ~N91{4yk!`I};uISpxin)0e4uU_zc)0rca?qW&wa`* zjEG8=DQku8!Z3(qIOsYmzRwy(=U?EQaZ0S%r(mChD+=)?0YwAb5gyC2^n z!9jl*&3#w46EAX$$kwTB$6rVr6&m_JmT{P(hS3pPIV)^&Q*mUqyZUZe_e5i$i+G<@ zi4@!bE~`t%KZWMjHjY@8`r~ksxJhC5T+i?e=UQSFez3ZA64g{B-2pMyj>K_P?_%5$ zDd_@5)MEBh=Q3g)I-FQ#N*AyF=^mLT0UqMKm!yU)i`k&1KDIV$lqAk6BfAJ9eEhuJ|=tk z*FDkpT*L5aCMSK%x(Rt@{=|`-moLdt84IAqB%g51IvV0RN!Mioo0#4>k`Ouv6euF% zZ3@a))**W9)Vy0~e9dnAeye2;eEE?-IKr%4CP784aXPpxu+MQ~cTgQHz|$NM@93n> zh-0c~aNYA=t$b#)L+?>JP!#0CVrxi_F;+J&DY@E70;x)Wjcf5trS?02##>Q536N=< z3{1F@UPw5P(c!K6{341?iuK=9kb2C)V3lg?)ba(Gm2Uri4!A2ienz)F3 zUN7&u_SbM)RbbHb!%S-{)4F?R>zFmo!E@1B(0F)+{CE|i+}X&7=S)MIdrJ#6yvL97 zqUYb-X$0@W!7}JjMY8ozwICeruSZnl0j;+;Zhx@(7t`3ebLlpIwksN7n0A@1-JNws zdSQkpq1|!kB1h7fL4Sy@O6jexk*@pRNNT8Uji=dWwL9fk!*HFxnrxmBa%5JMi``qy z)P^nAeCz4e0+lQUA^&0F^-3j;%)qlBO}bPA^K*IJ4S7nO4)1bW%!L6moCR}vzj(d* z{OVC*`Pa5u1c%o*ic4H?itBQlbXTx1wngc;_r`JVv9kd5^M1sSoH!s{dR;`%zy5}M z03UaOpt&UWO0^99`1Luvl24IS3IP`s3-vVK^CxovqSBI_;b7%Lx-|W8&-jzhhewjR zzf+h7Ky}@KXQ#jSq#PtOn})A`vuaIu#^=NC!k_a))8(yEz_&I4BtH0O(uWjZ;bd1KnidioMg-hW62fK-+rpCyJoB$&MO zysQ6t33+N+dQfL3P!D3FQ(s6q9kWfW87tH$h;{`(<-;$iDLe%2EmIvauY=&gf)XP^gUE;Mfj zw{idwML}I%WSWo7U6yBCaMkuv6}ctu*A=||9Yf@Xy^eQC&*AmmV$!r(ZDL^1yR^SE!(okue@1K7MBF{( z`^N^iBBg|+L}aAI;toX(Pz?m4e1P>c$gx_533gOMUv|&$)q(#~dDhg7{L^vaB_}P} z?X4gM3zv>7Cs`=nzqSnst+oivl#Q{(l$;d;xmeM*9;@?8qtEw_xAO9cP12ER{X_GA zlcEh)qO`>yWw1WGhH2|DFEEXW!0w{9vf(cic`;8YykS8q8oW^Ku&h-wx_B(9p*RF5 zu(rm>Rc#NyW8jS4j^ZrvrA+XJUs}epk$!&D9qGwwbp^se3)3r;j?dOMXQEB~B=*>~ zen9eNL@w*Rmbc*MGOrQ<`OTm(O(u8eTCT`F(8P;xl#O!Y?nMs(^DInloWce*uljW+ z0qe#FQ-a(4$^V&W;laq@^VJF9wO;6@du$fqtst$8vOo7LEg`{WqDt^x9uc!ZkSWdP zLVGJ)>CE>pLa&keJT}iP|P~9ubqFBw3RrlUf?B)Z!Yw>7i`K^OgV2jvd-7;hR zY_#nYXR&p41N2)zKm)eHC*J39hlfnF78`Yi$wc2f9wYwpFOG!9fwe~3^g9?vu}-SVJTAu1C_?Nlf~gtV1swd@rb z)nuhd`Eei5wG}$>I5vFwd+F%Eaew`M(%x0H4 zgkJPM$7hnkS0VP-m2d9*qO~IjbLDidyd}QFgR%$Ea_rsO?gq4J_?@t)>u z(|3#?6wJ;@tD$rv)Gw=w2oEn(WPlyGTrB|W`&H+@dHd2D3S=-O)gZD%F)^|3Md&VX zI#`O5q`3lYDf#~LCd)&JI@j;?94l0yOknnc4!iGhevh8F!PRHpBd#DnR7L7<5s{Uz z6Z9z;^{Ab7h6!#~CS;)WUCS>cDLlvL>tWb3NhoG_@Mn$Xj}wBRc+WM7N(w(5j7m^? zqH}N=wZu4KhPK>|`Lu~gM;B+Y^~xuC1Q?_go;?|nbW%=I{^KDD@>MJpP(_40lzuUi!hGgLoG?D)XB;d)KeM9pC6U{np^{khm(&My zOXQ+6?^LbfSXehNfs~!i#%@qY9(nSyvQAoI5B+F7Lqos3X1V@Ok2pv!P}Wd4jl~}x z6*hjrK~N7Yi!)2z&TQ#lcrYha<7R=@OMBgc^cgw&h~cEScs0e=xidmOtekp_k87xe zB$&%+>F`#32W@o(li}gw63Pwj-<{L^TuLpj^V|l~`}9S@jJJ;rp1j$5EF7f!DadeB z0`|p{61BD|H9HRhyYvT_&IUvfg*^7DBW>#hO0XGTBvfYZyc4wmt zm$cUF4h!w*)xPUa@W~~Yx7&7Tfq61sfRb=tuTQFfJ=gEf%@Q11Fwl{zoU53~9k~69 zFy8e$IoeURWPlgsc602TH?5DMq6K1#vED}32#Gk;WCw<;FlwS`cO}gHF_qU1F=cDl z#Kgp;iq3tTmAMk+owJJ_R^f9i4jteDf%`@j`>9#1yIS5*1^M-^i}2UD#~T0{#*_dF z7Vnx_@%EAL8*cWW<~&l>hDxf`eIT}pUS!D4CXRicS4SB%>yOdvvqni|1TC+-#iW<6 zMxf4L&pa8*4P7S}9=N#whZs0LlH6n}KX@}72Gay(o5g#N%2u}DQm`9bF7y-&FF7Sp zjNdVVDiaKzzU5JW!QUfC&Kvvz`xTj0k)4h7tsw?~F;tsgaE^Hjw>VR8&_{3Z@}?y> zTUJuiUntqDlLx1)j?0Iic3o@KgXoFV_;L~^^e8s-XE^fKGhbzAwb$=9KJ@SY5)2u<{ z*x|rPBS4@NtpI-Mt7>gz=Dv141EAn6O_Mh+s$D-1-0)3{1v(oY=<1MwIm%&iWpx~r zW)M5VYG*I!31WFoz8I5DkE%ZtF0wLm&cNT8g zzIs$fMn_atM6wr;Fnz}e$mWCy4|+Tuk8w2zzF~F9qinRhOC0W8-|$#xfJRYOW#}sr zC9e25)4_aZ1-DYO1NIT9k}F@NUb}IFlB7s}yD8-@s_BW=)?Q5w!@XI{hf#&@N0TDV zYG>x?*B)0*DaCFbGgkN(PK*Gx*w{|IuAbw!Up_CbR3}vwUD{-}cBN!GD94AcG3#HH7)*4<2PRk*^N2484A=ByVij7`AeK-!lL5k+h67ryr zwGN!I?It8*b|vj519Wkcy-=}g=)ikcM%3N@GZ^<%XVvL!;B33DHwTp(=BQ?$#e&$l z2#<_B8rt;pmloFay{E-ilr$mg+X%?BA%l!X`}V0B3V+UeWCa>Q1C6X>AkZDa`|dSz1N5bwY?Vvq&c@f z>dKr1!FBz>jJMaFE=1)-Ml{=#(QSekMb6Ypn7nd&_RvcH1@GrUOB9y&nq0r^pg#e& zfy|M5dHnaI+J(wU#^8QqRG^9VIJNc$M$3!ZvnNd~wy(dwh0f}A9+Jh}dpn!-Vc1_q zFu~a2Fn*3y5U$9~jV2rg zDD=)CDgbK$1-W2W*jtm1v8C}w9+i!lL;cai$xzS^SQqLgCxLJ>=`1gvJ4o$Zo($1NHNkwGEbi=I$%u|>T0tws z(PS=`kbdZfoPoU>7>k|u5p;Xkq~ofg@uYO8e&!Gf1fM@FI+JwYrPg`x{25?q61-IG z0x8Z7k#=;vGyXWk2|+1IO1Zw!wy?^%QsOZ) zI)tyvxjb{SceF=FxxTrJDK%dmHMULg2=59RSR(Pb+8X#OgOQVeheUGH@op5dSyDSY zV}1^axb{4ns7fbI=l8-B_j$c4n9Ji@TI0(`E;}&(9s=O&(F?Z{>uYnaHmSSoe9qa1 zBuIM6qg&1)jr7CBBqSmH$qn*NmoxdNWmFx0$c1kA)`{wL8;&fDCC9s>4a1{k7GR`J z3pJ%8$6aE2j-Tiy(lFhA?q?yZR7S~)NrXMeFG(c(e8u;9w;6$SAX-Ss$SDF4Z>8G0 z+|+m>M6!C;!Z)4P?TGRplhsOB?vXueNEcl#lMV47->8;QSZ+iWo`>(W9QjiV^@95s zcmS@=*Ivz?aCra??~*)63JHy3gkF|FvZJdxzqv`R69`TdgL=H}yU<5g)gDsKAtz-l z-ncgiU9unJFc=74{=7GY_WUXg=jeRMIq&G?qxah}T!m4G@fzas(h;Ly2^M19(&~Ia zBKsLN2Dvi_qU_Wpe0z*Fs2E_SdJT;+NoWTlMalmI`s+VPx1KNuBsyVk)?O}gN@V*v z@#5`a9J55y+~;7LrDDS+Y6suWRzl4!VSlIsbfJ`MWz3}Xo;1iBwoe_VRP7}M)}*Y* z(!c68w=S=ju6|RKo<9ZFx3ya+)M8?S=>4_V^CjxSGuqqQAB~)we{0VVVapw8>-ua+ z1{MgfFsACCT3zMg7;S38H!Z9;EkD%Vo7+0FvZnN{sRGA^LWKU`zKPvPE@lvyc_B4GkS8W`?2Qe;uT7PzH)m1DNs~1v>oik z@CU~rSoj=X^fh~Y>>1!IX#jY~d;rkHg$^j1pY?ry68!?d2u)xC|L63d-{JqrAm9YX?D4UdZBhqtLVvQMK0_n)_1Lb_ St@jiF)6+K8D%QOJ^1lFjC{+jm literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/ternary-computing/all/index.html b/apps/website/public/ru/learn/ternary-computing/all/index.html new file mode 100644 index 0000000000..46b733ca7b --- /dev/null +++ b/apps/website/public/ru/learn/ternary-computing/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Троичная машина: от трита до работающей программы: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

Троичная машина: от трита до работающей программы

+

В каждом уроке есть что нажимать. Каждый виджет исполняет тела fn спеки t27, скомпилированные в WebAssembly, поэтому триты на экране — это работа самой спеки, а рядом её можно открыть в плеере.

+

Курс 8, 27 уроков, в каждом живой виджет и спека t27: почему три, сбалансированная троичная система, трёхзначная логика, сумматоры, умножение без умножителя, триты в двоичной памяти, командное слово TRI-27, троичная машина и троичные нейроны. Каждое число в виджете вычисляет скомпилированная спека t27.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

0 из 27 пройдено

+

Открыть интерактивный курс →

+
+

Модуль 1 · Три значения

Почему три, как сбалансированная троичная система пишет любое число без знака и что дают переворот и отсечение тритов.

+
+
01

Урок 1 из 27

Почему три

+
+

Вы узнаетеПочему основание 3 — самое дешёвое целое основание для записи чисел и что этот довод упускает.

Число в системе с основанием b занимает сколько-то цифр, и каждая цифра должна различать b состояний. Если цена цифры равна b, число стоит b, умноженное на число цифр. Виджет запускает собственную cost() спеки: любое число до 999999 стоит 39 в основании 3 и 40 в основаниях 2 и 4. На длинном отрезке цена одной цифры равна b / ln b, и минимум у неё в точке e; 3 — ближайшее к ней целое. Модель не объясняет, почему победила двоичная система: элементы на два состояния дёшевы, быстры и надёжны.

Попробовать

Переберите все диапазоны и отметьте самое дешёвое основание; найдите диапазон, где выигрывает основание 2, и объясните, почему кривая всё равно за 3.

+
Why three: what a number costs in each baseВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/radix_economy.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Сбалансированная троичная

+
+

Вы узнаетеКак цифры -1, 0 и +1 записывают любое целое, отрицательные тоже, без знака.

В сбалансированной троичной системе веса разрядов 1, 3, 9, 27, а каждая цифра равна -1, 0 или +1. Тогда 8 — это 9 - 1, а -8 — это -9 + 1: знак живёт в самих цифрах. Шесть тритов покрывают числа от -364 до +364, и у каждого числа ровно одна запись. Плитки под счётчиком — это trit_at() спеки, вызванная по разу на разряд; один из её тестов восстанавливает каждое число от -400 до 400 из его тритов.

Попробовать

Посчитайте от -13 до 13 и следите, какая плитка меняется; найдите число, на котором появляется четвёртый трит.

+
Balanced ternary: count with -1, 0 and +1Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Переворот вместо минуса, отсечение вместо округления

+
+

Вы узнаетеПочему смена знака — это переворот каждого трита, а отбрасывание разрядов уже и есть округление.

В дополнительном коде смена знака — это инверсия плюс один; в сбалансированной троичной достаточно перевернуть каждый трит, и negate() спеки делает ровно это, разряд за разрядом. Отсечение k младших тритов даёт ближайшее кратное 3^k: 8 без одного трита — это 9, 7 — это 6. Ничьей быть не может: отброшенная часть всегда меньше половины шага, поэтому правило округления не нужно.

Попробовать

Нажмите переворот для 8 и для -121; затем отсеките у 13 один и два трита и сверьте каждый результат с ближайшим кратным.

+
Flip every trit to negate, cut trits to roundВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Логика с «не знаю»

Трёхзначные вентили Клини, два вентиля без двоичного двойника и сложение как пара таблиц.

+
+
04

Урок 4 из 27

Трёхзначная логика

+
+

Вы узнаетеКак NOT, MIN и MAX расширяют булеву логику значением «не знаю».

Пусть -1 — ложь, +1 — истина, 0 — «не знаю». Тогда И — это минимум, ИЛИ — максимум, а НЕ — переворот: сильная логика Клини. В четырёх углах каждой таблицы 3 x 3, где нет неизвестного входа, это в точности булева логика; средние строка и столбец показывают, что знает схема, когда вход неизвестен. Спека урока записывает их как t_not(), t_min() и t_max(), а её тесты проверяют булевы углы.

Попробовать

Найдите клетки MIN, где неизвестный вход не меняет ответ, и такие же клетки MAX.

+
Three-valued logic: NOT, MIN and MAXВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Консенсус и «любой»

+
+

Вы узнаетеДва вентиля, которые имеют смысл только при трёх значениях.

CONSENSUS сохраняет значение, в котором сходятся оба входа, а иначе отвечает «не знаю»; ANY берёт тот вход, который определён, и отвечает «не знаю», только когда входы противоречат друг другу. При двух значениях ни у одного из них нет пары, и это одна из причин, почему у двухвходового троичного вентиля 19683 возможные таблицы. Оба — тела fn из trits.t27, проверенные на парах входов, которые их различают.

Попробовать

Найдите входы, где CONSENSUS и ANY отвечают по-разному, и придумайте задачу с датчиками, где каждый из них был бы верным выбором.

+
Consensus and any: gates binary logic does not haveВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Сумма и перенос

+
+

Вы узнаетеКак сложение двух тритов распадается на таблицу суммы и таблицу переноса.

Два трита в сумме дают число от -2 до +2. В сбалансированной троичной записи это трит суммы плюс трижды трит переноса: +1 + +1 = 2 = 3 - 1, перенос +1, сумма -1. Виджет показывает оба как вентили. Если считать таблицы, у двухвходового троичного вентиля 3^9 = 19683 вариантов против 16 в двоичной. Спека урока собирает XOR из троичных нейронов: аппаратная сторона той же идеи.

Попробовать

Найдите две пары входов, у которых перенос не равен 0, и проверьте для каждой a + b = sum + 3 x carry.

+
Sum and carry: addition as two gatesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/ternary_xor.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Складываем триты

Полусумматор, полный сумматор и перенос, бегущий влево разряд за разрядом.

+
+
07

Урок 7 из 27

Полусумматор

+
+

Вы узнаетеДва трита на входе, трит суммы и трит переноса на выходе, все девять случаев.

Полусумматор — это таблицы суммы и переноса, поставленные рядом. Спека вычисляет обе из trit_at() от a + b: разряд 0 — сумма, разряд 1 — перенос. Из девяти пар входов перенос дают только +1 + +1 и -1 + -1; всё остальное умещается в один трит. Двоичный полусумматор переносит в одном случае из четырёх, троичный — в двух из девяти.

Попробовать

Пройдите все девять случаев в полосе и посчитайте, сколько из них дают перенос; сравните с четырьмя случаями двоичного полусумматора.

+
The half adder: two trits in, a sum and a carry outВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Полный сумматор

+
+

Вы узнаетеПочему три трита всё ещё умещаются в один трит суммы и один трит переноса.

Полный сумматор добавляет перенос из младшего разряда. Три трита в сумме дают -3..3, и этот отрезок всегда равен 3 x carry + sum, где оба — одиночные триты; тест спеки проверяет все 27 случаев. Спека урока в плеере — другая машина: ternary_full_adder.t27 строит двоичный полный сумматор из троичных нейронов, как это делает работа репозитория с BitNet на FPGA. Одно слово, два смысла, и оба запускаются.

Попробовать

Поставьте все три входа в +1, затем в -1; прочитайте перенос и сумму и найдите случай, где перенос равен 0, хотя ни один вход не 0.

+
The full adder: a carry comes in, a carry goes outВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/ternary_full_adder.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Сквозной перенос

+
+

Вы узнаетеКак ряд полных сумматоров складывает два числа, а перенос идёт влево.

Поставьте полные сумматоры в ряд, по одному на разряд, и подавайте перенос каждого в следующий: получится сумматор со сквозным переносом. Виджет открывается на 13 + 1: разряд единиц даёт 2 = 3 - 1, поэтому перенос +1 проходит три разряда, и +++ превращается в +---. ripple_add() спеки сверяется с обычным сложением на 198 парах. Спека урока собирает 2-битный двоичный сумматор со сквозным переносом из тех же троичных деталей.

Попробовать

Нажмите запуск и остановитесь на столбце, где перенос впервые снова становится 0; затем попробуйте 40 + 41.

+
Ripple carry: add two numbers trit by tritВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/ternary_ripple_adder.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Умножение без умножителя

Копия, ноль или переворот: произведение на один трит, умножение столбиком и MAC, который только складывает.

+
+
10

Урок 10 из 27

Умножить на один трит

+
+

Вы узнаетеПочему умножение на -1, 0 или +1 — это переключатель, а не умножитель.

У произведения на один трит три случая: +1 копирует число, 0 его обнуляет, -1 переворачивает каждый трит. trit_times() спеки — ровно такой переключатель, и умножения в нём нет. Поэтому троичные нейросети дёшевы в железе: весу -1, 0 или +1 нужен мультиплексор и инвертор, а не умножитель.

Попробовать

Умножьте 25 на каждый трит и сравните плитки; затем объясните, почему вес 0 ничего не стоит в железе.

+
Times one trit: copy, drop or flipВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Умножение столбиком

+
+

Вы узнаетеКак n x m превращается в строки копий, нулей и переворотов.

Каждый трит m выбирает копию, ноль или переворот n, сдвинутый на разряд в каждой строке; сумма строк и есть произведение. 7 x 8: 8 — это +0-, поэтому строки равны -7, 0 и 63, а их сумма 56. Таблицу умножения учить не нужно: только переключатель прошлого урока и сумматор. long_mul() спеки сверяется с n x m на 243 парах.

Попробовать

Найдите пару, у которой средняя строка — копия, а остальные строки — нули; затем умножьте 13 на 13.

+
Long multiplication in balanced ternaryВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Троичный MAC

+
+

Вы узнаетеКак скалярное произведение с троичными весами превращается в сложения, вычитания и пропуски.

Блок умножения с накоплением на каждом такте прибавляет вход, умноженный на вес. С весами -1, 0 и +1 каждый такт — это сложение, вычитание или ничего: девять тактов виджета дают 4 сложения, 2 вычитания и 3 пропуска и приходят к -8 без единого умножителя. Спека урока, ternary_mac.t27, — аппаратная версия: скалярное произведение 27 тритов в упакованных векторах, 2 бита на трит.

Попробовать

Меняйте веса, пока аккумулятор не придёт к 0, а затем к самому большому значению, какое получится.

+
A MAC with ternary weights: add, subtract or skipВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/ternary_mac.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Триты в двоичной памяти

Два бита на трит, пять тритов на байт и сколько бит нужно слову из 27 тритов.

+
+
13

Урок 13 из 27

Два бита на трит

+
+

Вы узнаетеВо что обходится хранить трит в двоичной памяти простым способом.

Двоичная память хранит трит в двух битах: -1 как 00, 0 как 01, +1 как 10, так упаковывают триты аппаратные спеки этого репозитория. Код 11 ничего не значит. Трит несёт log2(3) = 1.585 бита информации, поэтому два бита заняты на 79.25%: пятая часть памяти не несёт ничего.

Попробовать

Выберите каждый трит и прочитайте его код; скажите, что декодеру делать с 11, и проверьте, что делает decode2() спеки.

+
A trit in two bits, and the code nobody usesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Пять тритов в байте

+
+

Вы узнаетеКак 3^5 = 243 умещается под 2^8 = 256 и что значат 13 лишних кодов.

У пяти тритов 243 комбинации, а у байта 256, поэтому пять тритов умещаются в байт, и 13 кодов остаются лишними. Спека упаковывает их как число в основании 3, каждый трит плюс один, а распаковывает делением. Так используется 99.06% информации байта против 79.25% при двух битах на трит. Байты от 243 и выше вообще не являются кодами.

Попробовать

Упакуйте +1 +1 +1 +1 +1 и прочитайте байт; затем поставьте байт 243 и объясните, что говорит виджет.

+
Five trits in one byte: 243 of 256 codesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Слово из 27 тритов

+
+

Вы узнаетеСколько бит нужно слову из 27 тритов и насколько плотно оно их использует.

k тритам нужно наименьшее число бит b, при котором 2^b не меньше 3^k. Слово из 27 тритов, размер регистра TRI-27, покрывает плюс-минус 3812798742493 и требует 43 бита. Доля занятых бит растёт пилой к 1 по мере роста слова: широкие слова почти ничего не теряют, узкие — до пятой части.

Попробовать

Найдите длину слова больше одного трита с худшей долей и длину, ближайшую к 100%.

+
A word of 27 trits and the 43 bits it needsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Командное слово TRI-27

32-битное слово, которое декодирует эмулятор Trinity: его поля, 47 опкодов и 15-битное непосредственное значение.

+
+
16

Урок 16 из 27

Командное слово

+
+

Вы узнаетеКак эмулятор TRI-27 упаковывает команду в 32 бита.

Машина TRI-27 считает тритами, но её команды — 32-битные двоичные слова, которые декодирует закреплённая версия эмулятора Trinity. Опкод занимает биты 7..0, регистр назначения — 12..8, источники лежат выше; в форме с непосредственным значением старшие 15 бит отданы знаковому числу. Виджет вызывает encode() спеки и читает каждое поле обратно через opcode_of(), dst_of() и остальные.

Попробовать

Закодируйте ADD r1, r2, r3 и LDI r1 с 5; скажите, какие биты различаются и почему у формы с непосредственным значением поле src1 уже.

+
The TRI-27 instruction word, field by fieldВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/isa/ternary_encoding.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Карта опкодов

+
+

Вы узнаетеКакие из 256 байтов опкода что-то значат и что делают остальные.

Из 256 значений байта 47 — опкоды TRI-27, от NOP и LD через ADD, JMP и HALT до SYSCALL. Остальные 209 для эмулятора не ошибка: decode_opcode() читает незнакомый байт как NOP, поэтому декодирование никогда не падает. Спека урока, t27a_mnemonics.t27, даёт ассемблеру t27a строгий декодер, который такие байты отвергает.

Попробовать

Найдите байты опкодов ADD и HALT; затем нажмите неподсвеченный байт и объясните, почему строгий декодер надёжнее для ассемблера.

+
The opcode map: 47 of 256 bytes mean somethingВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/isa/t27a_mnemonics.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Непосредственное значение

+
+

Вы узнаетеКак 15-битное знаковое непосредственное значение обрезается, хранится и читается обратно.

Непосредственное значение живёт в 15 битах дополнительного кода: от -16384 до 16383. Спека прижимает всё, что выходит за край, к краю, а не заворачивает, поэтому 20000 превращается в 16383, а поле проходит путь encode и decode туда и обратно. Спека урока — ассемблер и дизассемблер t27a, которые пишут и читают одну и ту же таблицу в обе стороны.

Попробовать

Попробуйте 16383, 16384 и -16385; затем найдите непосредственное значение, у которого все 15 бит — единицы.

+
The immediate: fifteen bits, clamped, and read backВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/isa/t27a.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Троичная машина

АЛУ из сумматоров этого курса, переход на три стороны и программа, которую можно пройти по шагам.

+
+
19

Урок 19 из 27

Троичное АЛУ

+
+

Вы узнаетеКак сложение, вычитание, смена знака и сравнение работают на 9-тритных регистрах.

АЛУ этого виджета собрано из пройденного: ADD — сумматор со сквозным переносом, SUB прибавляет b с перевёрнутыми тритами, NEG — один лишь переворот, CMP отвечает одним тритом. Регистры из девяти тритов хранят от -9841 до 9841, и результат за этими пределами отмечается как переполнение. Спека урока, tri27_machine.t27, описывает машину TRI-27 так, как её исполняет эмулятор Trinity.

Попробовать

Вычтите 13 из 40 и прочитайте плитки; затем вызовите переполнение сумматора самой маленькой парой, какую найдёте.

+
A ternary ALU built from this course's addersВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/isa/tri27_machine.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Переход на три стороны

+
+

Вы узнаетеПочему одно троичное сравнение может ветвиться на три стороны.

Двоичная машина ветвится по флагу: чтобы различить «меньше», «равно» и «больше», ей нужно две проверки. Троичное сравнение отвечает одним тритом, поэтому одна команда может перейти в три стороны. Виджет сравнивает a и b по первому различному триту, подсвеченному золотым, и выбирает нужную цель. Машина следующего урока завершает свои циклы ровно таким переходом.

Попробовать

Заставьте переход пойти в каждую из трёх целей; затем найдите два числа, которые различаются только младшим тритом.

+
A three-way jump: one compare, three targetsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

Запустить программу

+
+

Вы узнаетеКак пять команд и один переход на три стороны дают цикл, который сам себя завершает.

У машины виджета три 9-тритных регистра и пять команд: SET, ADD, DEC, BR3 и HALT. Сумма 1..n кладёт n в r1, прибавляет его к r0, уменьшает, и BR3 прыгает назад, пока r1 положителен; на 0 выполнение проходит к HALT. При n = 5 машина останавливается с r0 = 15. Спека урока описывает контейнер .tbin, в котором поставляется программа TRI-27, так, как его читает загрузчик Trinity.

Попробовать

Пройдите программу суммы по тактам при n = 3; затем запустите 7 x n при n = 12 и посчитайте такты.

+
Run a program on a ternary machineВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/isa/tri27_bytecode.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Три ответа

Сравнение по старшему различному триту, поиск числа по третям и сортировка трёхзначными сравнениями.

+
+
22

Урок 22 из 27

Сравнение сверху

+
+

Вы узнаетеПочему числа в сбалансированной троичной сравниваются по первому различному триту.

В сбалансированной троичной триты ниже разряда i в сумме дают меньше половины 3^i, поэтому любое сравнение решает старший различный трит. 41 — это +----, а 39 — 0+++0: они различаются в старшем трите, значит 41 больше, хотя на его плитках четыре минуса. compare() спеки читает этот трит и сверяется с обычными «меньше» и «больше» на 714 парах.

Попробовать

Найдите два числа, которые впервые различаются в младшем трите, и два, которые различаются в каждом трите.

+
Compare at the first differing tritВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Вопросы по третям

+
+

Вы узнаетеПочему вопросы с тремя ответами находят число быстрее и попутно записывают его.

Спрашивайте, в какой трети диапазона лежит загаданное число, и каждый ответ будет одним из трёх: нижняя, средняя, верхняя. На диапазоне -121..121 ответы сверху вниз — это ровно пять тритов числа. Среди 243 чисел нужно 5 вопросов; вопросам «да или нет» нужно 8. questions3() и questions2() спеки считают оба случая.

Попробовать

Загадайте 23 и спрашивайте, пока оно не найдётся; затем загадайте -121 и скажите, какими были все ответы.

+
Twenty questions in thirdsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Сортировка трёхзначными сравнениями

+
+

Вы узнаетеКак сортировка пользуется сравнениями, которые умеют ответить «равно».

Три сравнения сортируют три числа: левую пару, правую пару и снова левую пару. Каждое сравнение сразу отвечает «меньше», «равно» или «больше», поэтому две равные семёрки решаются одним сравнением и никогда не меняются местами. Сортировке с повторами больше не нужна лишняя проверка.

Попробовать

Отсортируйте 7, -2, 7; затем найдите порядок трёх разных чисел, при котором не нужно ни одной перестановки.

+
Sort three numbers with three-way comparesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · Троичные нейроны

Веса -1, 0, +1: один нейрон, детектор и маленький слой, и нигде нет умножителя.

+
+
25

Урок 25 из 27

Один троичный нейрон

+
+

Вы узнаетеКак нейрон с весами -1, 0, +1 считает без умножения.

Нейрон умножает каждый вход на вес, складывает произведения и сравнивает сумму с порогом. С троичными весами каждое произведение — копия, ноль или переворот, поэтому сумма — это только сложения и вычитания. activate() спеки отвечает +1 на пороге и выше, -1 на минус пороге и ниже и 0 между ними: нейрон, который умеет сказать «не уверен».

Попробовать

Нарисуйте на входе вертикальную полосу и поднимайте порог, пока нейрон не перестанет срабатывать; затем меняйте веса, пока он не сработает на горизонтальную полосу.

+
One ternary neuron: inputs, weights, a thresholdВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/trits.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Детектор полосы

+
+

Вы узнаетеПочему веса нейрона работают как шаблон.

Дайте нейрону веса вертикальной полосы, и его сумма будет считать совпадения минус расхождения с ними. Вертикальная полоса даёт сумму 9 и ответ +1, перевёрнутая полоса — сумму -9 и ответ -1, горизонтальная полоса и диагональ дают 1, а шум — 0. Спека урока — тот же нейрон в железе: комбинационный нейрон BitNet на одном куске из 27 тритов.

Попробовать

Меняйте вход, пока сумма не станет ровно равна порогу 5; затем найдите самое маленькое изменение вертикальной полосы, после которого нейрон перестаёт срабатывать.

+
A bar detector: one neuron, four patternsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/comb_bitnet_neuron.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Маленький слой

+
+

Вы узнаетеКак несколько нейронов, читающих один вход, описывают его парой тритов.

Слой — это несколько нейронов, читающих один и тот же вход. Три детектора — вертикальный, горизонтальный и диагональный — превращают картинку 3 x 3 в три выходных трита: вертикальная полоса даёт +1, 0, 0. Сложите слои, и получится сеть; спека урока — слой из 4 нейронов в одном комбинационном модуле, а курс ai-numbers доводит это до целой сети на плате.

Попробовать

Нарисуйте картинку, на которую сработают сразу два нейрона; затем такую, на которую все три ответят -1.

+
A layer of three ternary neuronsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть спеку урока в плеере: specs/ternary/comb_bitnet_layer.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Три значения
    1. 01 Почему три
    2. 02 Сбалансированная троичная
    3. 03 Переворот вместо минуса, отсечение вместо округления
  2. 02 · Логика с «не знаю»
    1. 04 Трёхзначная логика
    2. 05 Консенсус и «любой»
    3. 06 Сумма и перенос
  3. 03 · Складываем триты
    1. 07 Полусумматор
    2. 08 Полный сумматор
    3. 09 Сквозной перенос
  4. 04 · Умножение без умножителя
    1. 10 Умножить на один трит
    2. 11 Умножение столбиком
    3. 12 Троичный MAC
  5. 05 · Триты в двоичной памяти
    1. 13 Два бита на трит
    2. 14 Пять тритов в байте
    3. 15 Слово из 27 тритов
  6. 06 · Командное слово TRI-27
    1. 16 Командное слово
    2. 17 Карта опкодов
    3. 18 Непосредственное значение
  7. 07 · Троичная машина
    1. 19 Троичное АЛУ
    2. 20 Переход на три стороны
    3. 21 Запустить программу
  8. 08 · Три ответа
    1. 22 Сравнение сверху
    2. 23 Вопросы по третям
    3. 24 Сортировка трёхзначными сравнениями
  9. 09 · Троичные нейроны
    1. 25 Один троичный нейрон
    2. 26 Детектор полосы
    3. 27 Маленький слой
+ + + + + diff --git a/apps/website/public/ru/learn/ternary-computing/index.html b/apps/website/public/ru/learn/ternary-computing/index.html index f0d7a75aca..681b690516 100644 --- a/apps/website/public/ru/learn/ternary-computing/index.html +++ b/apps/website/public/ru/learn/ternary-computing/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

Троичная машина: от трита до работающей программы

В каждом уроке есть что нажимать. Каждый виджет исполняет тела fn спеки t27, скомпилированные в WebAssembly, поэтому триты на экране — это работа самой спеки, а рядом её можно открыть в плеере.

Курс 8, 27 уроков, в каждом живой виджет и спека t27: почему три, сбалансированная троичная система, трёхзначная логика, сумматоры, умножение без умножителя, триты в двоичной памяти, командное слово TRI-27, троичная машина и троичные нейроны. Каждое число в виджете вычисляет скомпилированная спека t27.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/ternary-mac/index.html b/apps/website/public/ru/learn/ternary-mac/index.html index 14bbff49cc..47bcf159ca 100644 --- a/apps/website/public/ru/learn/ternary-mac/index.html +++ b/apps/website/public/ru/learn/ternary-mac/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Троичный MAC

Вы узнаете

Как скалярное произведение с троичными весами превращается в сложения, вычитания и пропуски.

Блок умножения с накоплением на каждом такте прибавляет вход, умноженный на вес. С весами -1, 0 и +1 каждый такт — это сложение, вычитание или ничего: девять тактов виджета дают 4 сложения, 2 вычитания и 3 пропуска и приходят к -8 без единого умножителя. Спека урока, ternary_mac.t27, — аппаратная версия: скалярное произведение 27 тритов в упакованных векторах, 2 бита на трит.

Попробовать

Меняйте веса, пока аккумулятор не придёт к 0, а затем к самому большому значению, какое получится.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A MAC with ternary weights: add, subtract or skip
A MAC with ternary weights: add, subtract or skip ↗

Nine inputs, nine weights of -1, 0 or +1. Each clock the accumulator adds, subtracts or does nothing. Press a weight to change it.

specs/ternary/ternary_mac.t27

module TernaryMac;
@@ -113,6 +145,7 @@ 

Троичный MAC

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/test-strength/index.html b/apps/website/public/ru/learn/test-strength/index.html index c171573cc4..8d45370ed9 100644 --- a/apps/website/public/ru/learn/test-strength/index.html +++ b/apps/website/public/ru/learn/test-strength/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сила тестов

Вы научитесь

Как измерить набор тестов, а не любоваться им: убитые мутанты, удалённые тесты, доля пустых проходов.

Покрытие говорит, что вы прогнали; мутации говорят, чего стоит ваше прогонянье. Сила набора — счёт убитых на выбранных вами неисправностях, поведение при удалении тестов, доля проходов, исполнивших ассерт. Виджет — эталонная сторона этого измерения: все 6 эталонных битстримов на месте и прочитаны — 84.4 мс из 5 прогонов — поэтому числу скорости или силы всегда есть на что встать: на эталон, который кто-то закрепил. Измеряйте набор — или признавайтесь, что любуетесь.

Попробуйте

Измерьте одну вещь дважды, двумя способами, в стиле виджета ссылок; затем скажите, какое число вашего набора живёт без знаменателя.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri x7-part · x7-refs · x7-bench: the references the bitstream path is checked on
tri x7-part · x7-refs · x7-bench: the references the bitstream path is checked on ↗

The part table in far.t27 matches prjxray-db part.json, all 6 reference bitstreams are present, and bitwalk reads all 6 in 84.4 ms (best of 5).

specs/tools/trios/tri/x7-mutate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -108,6 +140,7 @@ 

Сила тестов

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/tests-are-the-spec/index.html b/apps/website/public/ru/learn/tests-are-the-spec/index.html index 7aee829642..d01be60941 100644 --- a/apps/website/public/ru/learn/tests-are-the-spec/index.html +++ b/apps/website/public/ru/learn/tests-are-the-spec/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Тесты — часть спеки

Вы узнаете

Почему каждая спека t27 несёт свои тесты и что показывает временная диаграмма.

В t27 спека не закончена без своих утверждений: блоки test, инварианты и бенчи живут в том же файле, что и проверяемый ими код, а спеку без них компилятор отвергает. Тест можно запустить и как вентили в симуляторе. Диаграммы ниже — настоящая симуляция Verilog, сгенерированного из спеки троичного умножения с накоплением, на тестовых векторах этой же спеки.

Попробуйте

Приблизьте один такт и прочитайте значения на шинах в отметке pass.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Test waves: a t27 spec's tests, simulated and drawn as waves
Test waves: a t27 spec's tests, simulated and drawn as waves ↗

Verilog generated from a ternary MAC spec, driven by the spec's own test vectors under Icarus Verilog: clock, buses, pass marks. Drop a .vcd and it draws yours.

specs/tutorial/07_tests_invariants_benches.t27

// SPDX-License-Identifier: Apache-2.0
@@ -154,6 +186,7 @@ 

Тесты — часть спеки

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-butterfly/index.html b/apps/website/public/ru/learn/the-butterfly/index.html index ac3bd0c469..6e4b51fdb4 100644 --- a/apps/website/public/ru/learn/the-butterfly/index.html +++ b/apps/website/public/ru/learn/the-butterfly/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Бабочка

Вы узнаете

Как БПФ по основанию 2 разбивает ДПФ на этапы бабочек и что это экономит.

Бабочка берёт a и b, умножает b на поворачивающий множитель W и выдаёт a + Wb и a - Wb. БПФ по основанию 2 на N точек — это log2 N этапов по N/2 бабочек: 3 этапа по 4 бабочки на 8 точках, 5120 бабочек на 1024 точках против 1048576 умножений у прямого ДПФ. Виджет исполняет целочисленное БПФ спеки и показывает каждое значение: один период косинуса на 8 точках выходит как 509 в бинах 1 и 7. Спека signals.t27 вычисляет каждую бабочку.

Попробовать

По очереди подсветите каждый этап 8-точечного БПФ и сосчитайте поворачивающие множители, которые он использует; затем найдите этап, на котором значение входа DC удваивается.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The FFT butterfly: N log N instead of N^2
The FFT butterfly: N log N instead of N^2 ↗

Pick a size, an input and a stage. See every butterfly pair, its twiddle on the unit circle and the values flowing through, and count the work against a direct DFT.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Бабочка

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-carry-chain/index.html b/apps/website/public/ru/learn/the-carry-chain/index.html index 28216ec9fc..9097fbff5b 100644 --- a/apps/website/public/ru/learn/the-carry-chain/index.html +++ b/apps/website/public/ru/learn/the-carry-chain/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Цепь переноса

Вы узнаете

Почему перенос проходит всё слово и как выделенная цепь слайса делает этот путь дешёвым.

Бит i суммы a + b — это XOR битов a_i, b_i и входящего в него переноса, а выходной перенос — их мажоритарная функция. Перенос, рождённый в бите 0 суммы 127 + 1, должен пройти биты с 1 по 6, прежде чем старший бит узнает свой ответ: виджет подсвечивает эту серию из 7. Перенос, пересчитанный в LUT, стоит LUT и трассу на каждый бит; выделенная цепь слайса серии 7 стоит одну LUT и одну трассу, а затем один шаг на бит, блоками CARRY4 по 4 бита. Спека adders.t27 задаёт обе модели и оставляет три задержки вам.

Попробовать

Загрузите 127 + 1 и найдите самую длинную серию переносов; затем переключитесь на 85 + 170 и объясните, почему серия равна 0. Поставьте шаг 30 пс и сравните две задержки для 32 бит.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The carry chain: why adding is slow, and how a slice makes it fast
The carry chain: why adding is slow, and how a slice makes it fast ↗

Tap the bits of two numbers and watch the carry run up the word. Then set three delays and see what the dedicated carry chain saves over LUTs.

specs/fpga/dsp/adders.t27

// SPDX-License-Identifier: Apache-2.0
@@ -552,6 +584,7 @@ 

Цепь переноса

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-cic-filter/index.html b/apps/website/public/ru/learn/the-cic-filter/index.html index ced926931f..c33d1288d9 100644 --- a/apps/website/public/ru/learn/the-cic-filter/index.html +++ b/apps/website/public/ru/learn/the-cic-filter/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Фильтр CIC

Вы узнаете

Как дециматор CIC фильтрует без умножителей и на сколько бит должны вырасти его регистры.

Дециматор CIC — это N интеграторов на входной частоте, понижение частоты в R раз и N гребенчатых звеньев с задержкой M на выходной частоте. Его усиление на постоянном токе равно (RM)^N, поэтому регистры вырастают на ceil(N log2(RM)) бит: при N = 4, R = 8 и M = 1 это 4096 и 12 бит, 16-битный вход в 28-битных регистрах. Его характеристика имеет нуль на каждом кратном выходной частоты и проседает на 3.6 дБ на четверти её. Спека signals.t27 вычисляет усиление, рост и характеристику.

Попробовать

Задайте одно звено и сравните характеристику со скользящим средним; затем загрузите последний пресет и сосчитайте биты регистров.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The CIC filter: no multipliers, many bits
The CIC filter: no multipliers, many bits ↗

Set stages, rate change, delay and input width. See the sinc-shaped response with its nulls, and how many bits every register has to grow.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Фильтр CIC

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-comb-answers/index.html b/apps/website/public/ru/learn/the-comb-answers/index.html index 0ad12bafb9..6dbc2dbdd1 100644 --- a/apps/website/public/ru/learn/the-comb-answers/index.html +++ b/apps/website/public/ru/learn/the-comb-answers/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Соты отвечают

Вы узнаете

Как игра показывает, что с задачей что-то случилось, и как часто растёт карта.

В сотах игры у каждой задачи своя ячейка, и до hive.t27 принятая задача, потерянная аренда и отмена выглядели так же, как отсутствие новостей. cell_effect даёт каждому из 10 видов событий свою краску: старт белый, принявшее ревью золотое, возврат янтарный, потерянная аренда красная, отмена серая. flash_alpha гасит вспышку за FLASH_MS, 1800 мс. Новая ячейка перестраивает сцену, поэтому cells_due ставит новые ячейки пачками не чаще раза в 300 с.

Попробовать

Нажмите ячейку ревью и переключите вердикт; затем найдите момент, когда вспышка гаснет.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The comb answers: what an event does to a cell
The comb answers: what an event does to a cell ↗

Ten kinds of event reach the game. Pick one and the moment since: cell_effect colours the cell gold, amber, red, grey or white, flash_alpha fades it, and cells_due batches new cells.

specs/queen/hive.t27

// SPDX-License-Identifier: Apache-2.0
@@ -252,6 +284,7 @@ 

Соты отвечают

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-dsp48e1-slice/index.html b/apps/website/public/ru/learn/the-dsp48e1-slice/index.html index e441b0c0ff..cce1aecb45 100644 --- a/apps/website/public/ru/learn/the-dsp48e1-slice/index.html +++ b/apps/website/public/ru/learn/the-dsp48e1-slice/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Слайс DSP48E1

Вы узнаете

Как произведение раскладывается на умножители 25 x 18 и сколько слагаемых может просуммировать 48-битный аккумулятор.

Слайс DSP48E1 умножает 25-битное число на 18-битное в дополнительном коде в 48-битный аккумулятор, и у XC7A200T их 740. Произведению 25 x 18 нужно 43 бита, поэтому у аккумулятора остаётся 5 бит запаса: 32 слагаемых суммируются безопасно, а 33-е может переполнить. Более широкое произведение режется на куски, младшие на бит короче порта, потому что они беззнаковые: 32 x 32 занимает 4 слайса. Спека multipliers.t27 держит раскладку, защитные биты и запас.

Попробовать

Найдите самое широкое b, которое ещё помещается в один слайс рядом с 25-битным a; затем задайте 16 x 16 и найдите наибольшее число слагаемых, которое держит аккумулятор.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The DSP48E1 slice: fit a x b and its running sum
The DSP48E1 slice: fit a x b and its running sum ↗

Set two operand widths and a number of terms. See how many 25 x 18 slices the product takes and whether the 48-bit accumulator has room for the sum.

specs/fpga/dsp/multipliers.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

Слайс DSP48E1

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-frame/index.html b/apps/website/public/ru/learn/the-frame/index.html index 66f291210a..b808615d67 100644 --- a/apps/website/public/ru/learn/the-frame/index.html +++ b/apps/website/public/ru/learn/the-frame/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Кадр: старт, данные, стоп

Вы узнаете

Как побитово собирается кадр UART и что компилятор порождает для него.

Кадр UART — атомы шины: линия в покое держится высоко, стартовый бит тянет её вниз, следуют восемь бит данных, и стоповый бит возвращает её высоко. Тестбенч-спека последнего урока этого модуля проверяет сам покой: uart_tb_tx_idle_high и uart_tb_rx_idle_high — два из её семи тестов. Запись показывает, как компилятор опускает спеку до синтезируемого Verilog: модуль ZeroDSP_UART, его порты clk, rst_n, en, data и ready, дата-путь как провода.

Попробовать

В записи найдите имя модуля и его порты; затем в спеке найдите константы ширины и глубины кадра и FIFO.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on uart.t27 -- spec to RTL
t27c gen-verilog on uart.t27 -- spec to RTL ↗

The compiler lowers the UART spec to synthesizable Verilog: the TRINITY banner, the module port list and the datapath as wires.

specs/fpga/uart.t27

// SPDX-License-Identifier: Apache-2.0
@@ -297,6 +329,7 @@ 

Кадр: старт, данные, стоп

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-huber-loss/index.html b/apps/website/public/ru/learn/the-huber-loss/index.html index 7c7a3323ca..d7f029d27c 100644 --- a/apps/website/public/ru/learn/the-huber-loss/index.html +++ b/apps/website/public/ru/learn/the-huber-loss/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Функция Хьюбера

Вы узнаете

Как функция Хьюбера обходится с малой ошибкой как с квадратичной, а с большой линейно, чтобы выбросы тянули слабее.

Квадратичная ошибка позволяет одному выбросу всё решать: ошибка 3 стоит 4.5 как половина своего квадрата, столько же, сколько 36 ошибок по 0.5. Функция Хьюбера равна половине квадрата, пока |e| не больше delta, а дальше растёт только линейно, delta |e| - delta^2 / 2, так что при delta 1 та же ошибка стоит 2.5. Два куска сходятся с одинаковым значением и наклоном, и градиент никогда не превышает delta: далёкая точка тянет модель с ограниченной силой. Для пары ошибок спеки 0.5 и 3 среднее равно 1.3125 против 2.3125 для половины квадрата. Спека huber_loss.t27 вычисляет обе.

Попробовать

Поставьте delta на 0.5 и тяните ошибку к 3; затем найдите, где две кривые расходятся.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Huber loss: a loss that does not panic at an outlier
Huber loss: a loss that does not panic at an outlier ↗

Drag the error along: Huber is half its square inside delta and only grows linearly outside, so one wild miss pulls on the model with a bounded force. The dashed curve is the pure square.

specs/ml/loss/huber_loss.t27

// SPDX-License-Identifier: Apache-2.0
@@ -162,6 +194,7 @@ 

Функция Хьюбера

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-immediate/index.html b/apps/website/public/ru/learn/the-immediate/index.html index 9c4fb66235..ee2f647f9e 100644 --- a/apps/website/public/ru/learn/the-immediate/index.html +++ b/apps/website/public/ru/learn/the-immediate/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Непосредственное значение

Вы узнаете

Как 15-битное знаковое непосредственное значение обрезается, хранится и читается обратно.

Непосредственное значение живёт в 15 битах дополнительного кода: от -16384 до 16383. Спека прижимает всё, что выходит за край, к краю, а не заворачивает, поэтому 20000 превращается в 16383, а поле проходит путь encode и decode туда и обратно. Спека урока — ассемблер и дизассемблер t27a, которые пишут и читают одну и ту же таблицу в обе стороны.

Попробовать

Попробуйте 16383, 16384 и -16385; затем найдите непосредственное значение, у которого все 15 бит — единицы.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The immediate: fifteen bits, clamped, and read back
The immediate: fifteen bits, clamped, and read back ↗

An immediate lives in 15 bits of two's complement, -16384 to 16383. Push it past the edge and watch it clamp, then decode the word back.

specs/isa/t27a.t27

// SPDX-License-Identifier: Apache-2.0
@@ -762,6 +794,7 @@ 

Непосредственное значение

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-instruction-word/index.html b/apps/website/public/ru/learn/the-instruction-word/index.html index 2cc9f9f6a6..93869e01d7 100644 --- a/apps/website/public/ru/learn/the-instruction-word/index.html +++ b/apps/website/public/ru/learn/the-instruction-word/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Командное слово

Вы узнаете

Как эмулятор TRI-27 упаковывает команду в 32 бита.

Машина TRI-27 считает тритами, но её команды — 32-битные двоичные слова, которые декодирует закреплённая версия эмулятора Trinity. Опкод занимает биты 7..0, регистр назначения — 12..8, источники лежат выше; в форме с непосредственным значением старшие 15 бит отданы знаковому числу. Виджет вызывает encode() спеки и читает каждое поле обратно через opcode_of(), dst_of() и остальные.

Попробовать

Закодируйте ADD r1, r2, r3 и LDI r1 с 5; скажите, какие биты различаются и почему у формы с непосредственным значением поле src1 уже.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The TRI-27 instruction word, field by field
The TRI-27 instruction word, field by field ↗

Pick an instruction and its registers. The emulator packs them into a 32-bit word: opcode, destination, sources or an immediate.

specs/isa/ternary_encoding.t27

// SPDX-License-Identifier: Apache-2.0
@@ -546,6 +578,7 @@ 

Командное слово

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-merge-gate/index.html b/apps/website/public/ru/learn/the-merge-gate/index.html index f1bf2524c5..7ff7a51403 100644 --- a/apps/website/public/ru/learn/the-merge-gate/index.html +++ b/apps/website/public/ru/learn/the-merge-gate/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Ворота слияния

Вы узнаете

Когда мерджер может слить пулл-реквест, который одобрила пчела-ревьюер.

Пчела-ревьюер одобряет, мерджер сливает; merger_gate.t27 — правило между ними. check_passes пропускает зелёную проверку и задерживает любую, которая ещё идёт. Красная проходит, только если она не обязательная, завершилась и пчела назвала её списанной, а если набор правил не читается, обязательной считается каждая проверка. gate_open нужен хотя бы 1 опубликованный результат, 0 идущих и 0 блокирующих: ноль проверок — не ноль падений.

Попробовать

Дайте идущей проверке завершиться зелёной; затем сделайте набор правил нечитаемым и посмотрите на списанную красную.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The merge gate: when an approved pull request may merge
The merge gate: when an approved pull request may merge ↗

Four checks on a pull request the reviewer bee approved. Tap what each one is: check_passes judges it, and gate_open opens only when one has posted, none runs and none blocks.

specs/queen/merger_gate.t27

// SPDX-License-Identifier: Apache-2.0
@@ -370,6 +402,7 @@ 

Ворота слияния

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-module-line/index.html b/apps/website/public/ru/learn/the-module-line/index.html index 0ba3ac033c..88cc1e3bc2 100644 --- a/apps/website/public/ru/learn/the-module-line/index.html +++ b/apps/website/public/ru/learn/the-module-line/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Строка module

Вы узнаете

Как пишется строка module, какие имена она принимает и где стоит.

Строка module — это ключевое слово module, имя и точка с запятой. Перед ней могут стоять комментарии и строки прозы; объявления идут после. Имя состоит из букв, цифр и подчёркиваний; компилятор на этом сайте принимает и дефисы, как в tutorial-06-structs. Спека курса на этом сайте обязана носить имя модуля, которого ждёт её генератор, поэтому неверное имя ловит сборка, а не компилятор.

Попробуйте

В плеере поменяйте имя модуля в спеке урока и убедитесь, что вердикт остаётся чистым.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 2: the module line
t27 basics 2: the module line ↗

Which module lines the t27c compiler accepts, checked in the browser with the real compiler. Lesson 2 of the t27 basics course.

specs/basics/02_the_module_line.t27

// SPDX-License-Identifier: Apache-2.0
@@ -79,6 +111,7 @@ 

Строка module

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-moving-average/index.html b/apps/website/public/ru/learn/the-moving-average/index.html index 3443f40637..c61cf8c9a4 100644 --- a/apps/website/public/ru/learn/the-moving-average/index.html +++ b/apps/website/public/ru/learn/the-moving-average/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Скользящее среднее

Вы узнаете

Почему усреднение L отсчётов — фильтр нижних частот и где лежат его нули.

Усредните последние L отсчётов, и тон на f выйдет умноженным на |sin(pi f L) / (L sin(pi f))|. Для L = 4 это 1 на постоянном токе, 0.65328 на 1/8 частоты дискретизации и ровно 0 на 1/4: каждое кратное 1/L — нуль. Ему не нужен ни один умножитель, поэтому за него на FPGA берутся рано. Спека signals.t27 вычисляет характеристику и выход отсчёт за отсчётом.

Попробовать

Поставьте тон в нуль L = 4 и посмотрите, как выход исчезает; затем удвойте L и найдите новый нуль.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The moving average: a low-pass you can do in your head
The moving average: a low-pass you can do in your head ↗

Set how many samples to average and pick a tone. See the response, its nulls at multiples of 1/L, and the tone coming out smaller by exactly that much.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Скользящее среднее

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-nco/index.html b/apps/website/public/ru/learn/the-nco/index.html index d09b9dffda..fc912ac488 100644 --- a/apps/website/public/ru/learn/the-nco/index.html +++ b/apps/website/public/ru/learn/the-nco/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Генератор с числовым управлением

Вы узнаете

Как фазовый аккумулятор и таблица синуса дают любую частоту и насколько мелки её шаги.

Прибавляйте слово настройки M к N-битному аккумулятору каждый такт, и его старшие биты обегают круг с частотой f_out = M f_clk / 2^N. На 100 МГц при N = 32 слово M = 2^30 даёт 25 МГц, четверть оборота за такт, а соседняя частота отстоит на 0.0233 Гц. Старшие P бит фазы адресуют таблицу синуса; эмпирическое правило ставит наихудший паразит от усечения фазы примерно на 6.02 дБ на каждый оставленный бит ниже несущей. Спека signals.t27 выбирает M и вычисляет каждый отсчёт.

Попробовать

Попросите 1 МГц и прочитайте слово настройки и частоту, которую получаете на самом деле; затем урежьте таблицу до 4 бит фазы и посмотрите на выходные отсчёты.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The NCO: a phase accumulator and a sine table
The NCO: a phase accumulator and a sine table ↗

Set a clock, an accumulator width and a frequency. The spec picks the tuning word; watch the phase step around the wheel and the table turn it into a sine.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Генератор с числовым управлением

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-next-key/index.html b/apps/website/public/ru/learn/the-next-key/index.html index 22672f3774..888f3d911d 100644 --- a/apps/website/public/ru/learn/the-next-key/index.html +++ b/apps/website/public/ru/learn/the-next-key/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Следующий ключ

Вы узнаете

Какой ключ пчела пробует следующим и когда переходит к другому пулу или сдаётся.

На 2026-10-17 пчела начала на ключе 9 из 10 и погибла через 7 с, пока 33 других ключа простаивали: она получила один ключ при запуске и держала его. Теперь next_free берёт следующий после последнего ключ, который ещё не пробовали и который не отдыхает. 1305 — перегрузка модели пула, поэтому, когда POOL_OVERLOAD_KEYS, 3, ключа сказали это за минуту, step переводит пчелу в следующий пул. После 8 попыток ход заканчивается.

Попробовать

Отметьте ключ 2 как опробованный и посмотрите, какой ключ получит кольцо; затем поставьте три ключа, ответивших 1305.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The next key: a bee moves on instead of dying
The next key: a bee moves on instead of dying ↗

A pool of keys, some tried, some resting. Tap keys to change them: next_free picks the next one after the last, and step says next key, next pool or give up.

specs/queen/key_failover.t27

// SPDX-License-Identifier: Apache-2.0
@@ -451,6 +483,7 @@ 

Следующий ключ

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-night-watch/index.html b/apps/website/public/ru/learn/the-night-watch/index.html index 79f118987a..bc4f59d451 100644 --- a/apps/website/public/ru/learn/the-night-watch/index.html +++ b/apps/website/public/ru/learn/the-night-watch/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Ночной дозор

Вы узнаете

Что ночной дозор делает утром с четырьмя проверками карточек.

Каждую ночь идут четыре проверки чата карточек: тред, дверь статуса, слияния и паритет. night_verdict подводит итог: любое падение — это падение, иначе любое неизмеренное — неизмерено, иначе всё прошло. night_report превращает это в одно действие: падение открывает задачу или комментирует открытую, успех закрывает открытую задачу или молчит, а неизмеренная ночь оставляет всё как есть.

Попробовать

Сделайте ночь успешной при открытой задаче; затем сделайте одну проверку неизмеренной.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The night watch: four checks, one verdict, one report
The night watch: four checks, one verdict, one report ↗

Every night four card checks run. Tap each to pass, fail or unmeasured: night_verdict sums them up and night_report says whether to open an issue, comment, close it or stay silent.

specs/automation/card-chat-night-watch.t27

// SPDX-License-Identifier: Apache-2.0
@@ -213,6 +245,7 @@ 

Ночной дозор

}

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-opcode-map/index.html b/apps/website/public/ru/learn/the-opcode-map/index.html index 4c4e8d56d1..e376cf1a92 100644 --- a/apps/website/public/ru/learn/the-opcode-map/index.html +++ b/apps/website/public/ru/learn/the-opcode-map/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Карта опкодов

Вы узнаете

Какие из 256 байтов опкода что-то значат и что делают остальные.

Из 256 значений байта 47 — опкоды TRI-27, от NOP и LD через ADD, JMP и HALT до SYSCALL. Остальные 209 для эмулятора не ошибка: decode_opcode() читает незнакомый байт как NOP, поэтому декодирование никогда не падает. Спека урока, t27a_mnemonics.t27, даёт ассемблеру t27a строгий декодер, который такие байты отвергает.

Попробовать

Найдите байты опкодов ADD и HALT; затем нажмите неподсвеченный байт и объясните, почему строгий декодер надёжнее для ассемблера.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The opcode map: 47 of 256 bytes mean something
The opcode map: 47 of 256 bytes mean something ↗

Every byte from 0 to 255 as a cell; green ones are TRI-27 opcodes. Press a byte: an undefined one decodes as NOP, decoding never fails.

specs/isa/t27a_mnemonics.t27

// SPDX-License-Identifier: Apache-2.0
@@ -302,6 +334,7 @@ 

Карта опкодов

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-packet-bridge/index.html b/apps/website/public/ru/learn/the-packet-bridge/index.html index 4dc9a4b4a5..e39baa4e7a 100644 --- a/apps/website/public/ru/learn/the-packet-bridge/index.html +++ b/apps/website/public/ru/learn/the-packet-bridge/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Пакетный мост

Вы узнаете

Как пакетный мост переносит работу между шинами и чего стоят его буферы.

Пакетный мост переносит работу между шинами пакетами: буферы RX и TX по 256 байт каждый, SPI-буфер на 64, MAX_PACKET_SIZE 128, PACKET_TIMEOUT 10,000 тактов и коды операций OP_MAC_MUL, OP_MAC_MAC и OP_MAC_MACC для работы, которую он несёт. bridge_buffer_count_wrap и bridge_buffer_count_wrap2 проверяют арифметику на шве. Запись опускает спеку моста в синтезируемый Verilog.

Попробовать

В записи найдите порты модуля моста; затем в спеке найдите четыре константы буферов и таймаут, а также три кода операций.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen-verilog on bridge.t27 -- spec to RTL
t27c gen-verilog on bridge.t27 -- spec to RTL ↗

The bus bridge spec lowered to synthesizable Verilog: both sides of the crossing as generated wires.

specs/fpga/bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -591,6 +623,7 @@ 

Пакетный мост

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-prescaler-ladder/index.html b/apps/website/public/ru/learn/the-prescaler-ladder/index.html index e0c831eb42..17e585ac40 100644 --- a/apps/website/public/ru/learn/the-prescaler-ladder/index.html +++ b/apps/website/public/ru/learn/the-prescaler-ladder/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Лестница предделителей

Вы узнаете

Как лестница предделителей превращает один такт в семейство частот SCK и какие ступени допустимы.

Один такт становится семейством частот через лестницу предделителей: PRESCALER_2 равно 0, PRESCALER_4 равно 1, и лестница поднимается, пока такт держится. spi_prescaler_16_default проверяет значение по умолчанию, spi_set_prescaler_valid и spi_set_prescaler_invalid — границы, spi_sck_freq_at_50 — арифметику. Запись — нативный прогон: тестбенч-спека SPI через настоящий t27c, 7 тестов проходят.

Попробовать

В записи посчитайте проходящие тесты; затем в спеке перечислите константы предделителей и найдите тест, проверяющий значение по умолчанию.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on spi_tb.t27 -- simulating the SPI testbench
t27c on spi_tb.t27 -- simulating the SPI testbench ↗

t27c test-report on the SPI testbench spec: 7 tests pass natively -- the bench drives the modes and checks the captures.

specs/fpga/testbench/spi_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Лестница предделителей

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-public-board/index.html b/apps/website/public/ru/learn/the-public-board/index.html index d578ff6596..9db82666d9 100644 --- a/apps/website/public/ru/learn/the-public-board/index.html +++ b/apps/website/public/ru/learn/the-public-board/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Публичная доска

Вы узнаете

В какой колонке публичная доска рисует каждое притязание и в каком случае ошибается.

Доска на app.t27.ai/game/kanban рисует каждый запуск в одной из 6 колонок. column_of читает притязание запуска на его задачу: running — в работе, accepted — готово, rejected и awaiting review — на ревью, failed — сброшено. dispatch.t27 записывает одну находку как есть: когда задача закрыта и список прочитан, любое завершённое притязание рисуется как готовое, каким бы ни был вердикт.

Попробовать

Откройте задачу и посмотрите, куда уйдут четыре завершённых притязания; затем скажите, что скрывает закрытая задача.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The public board: which column a task's card is in
The public board: which column a task's card is in ↗

Five claims a dispatch can hold on its issue. Close the issue: column_of moves every finished one to done, whatever its verdict.

specs/queen/dispatch.t27

// SPDX-License-Identifier: Apache-2.0
@@ -662,6 +694,7 @@ 

Публичная доска

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-queens-move/index.html b/apps/website/public/ru/learn/the-queens-move/index.html index 361b50443e..9b3d5e0425 100644 --- a/apps/website/public/ru/learn/the-queens-move/index.html +++ b/apps/website/public/ru/learn/the-queens-move/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Ход Королевы

Вы узнаете

Что Королева делает в каждом заторе и каких заторов она ждёт.

У каждого случая одно действие на той же позиции: no reviewer отправляет ревьюера, refused not fixed отправляет кодера, refused then pushed отправляет повторное ревью, а labeled not merged завершает слияние. jam_action переводит любое значение больше 9 в measure again, так что неизвестный случай никогда не значит «делать нечего». jam_is_queens_turn ложно для 3 случаев — none, draft or fresh и stacked on an open PR: их она ждёт.

Попробовать

Найдите случай, чьё действие — ждать базу; затем дотяните до 200 и прочитайте действие.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The Queen's move: what each jam asks of her
The Queen's move: what each jam asks of her ↗

Each jam case has one action at the same position. Drag the case: jam_action names the move, and jam_is_queens_turn splits the board into her turn and waiting.

specs/automation/review-jam.t27

// Review jam: which case a stuck pull request is in, and the Queen's action.
@@ -342,6 +374,7 @@ 

Ход Королевы

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-queue/index.html b/apps/website/public/ru/learn/the-queue/index.html index 4135661df5..a29412c8fd 100644 --- a/apps/website/public/ru/learn/the-queue/index.html +++ b/apps/website/public/ru/learn/the-queue/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Очередь

Вы узнаете

Как потолок, старение и блокеры упорядочивают очередь открытых задач.

Метки раздуваются: если каждая задача критична, критичных нет. capped_level позволяет идти как critical не больше чем CRITICAL_CAP, 3, задачам списка, в порядке списка, а 4-я идёт как high. Задача с открытым блокером пропускается, её не ждут, и она не может задержать очередь. outranks сравнивает уровень с учётом старения, затем настоящий уровень, затем место в списке, так что постаревшая задача никогда не обгонит настоящую своего уровня. why называет причину каждого места.

Попробовать

Сделайте критичной пятую задачу и посмотрите, куда она встанет; затем поставьте задаче без метки метку low.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The queue: which issue the Queen takes first
The queue: which issue the Queen takes first ↗

Seven open issues in GitHub order. Tap one to change its label: the cap, aging, blockers and outranks reorder the queue, and each issue says why it sits there.

specs/queen/priority.t27

// SPDX-License-Identifier: Apache-2.0
@@ -231,6 +263,7 @@ 

Очередь

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-review-jam/index.html b/apps/website/public/ru/learn/the-review-jam/index.html index 75ed987c76..b3eaf5becd 100644 --- a/apps/website/public/ru/learn/the-review-jam/index.html +++ b/apps/website/public/ru/learn/the-review-jam/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Затор ревью

Вы узнаете

В каком из десяти случаев застрявший пулл-реквест и почему побеждает правило, совпавшее раньше остальных.

Пулл-реквест может застрять сразу по нескольким причинам: отклонён, снова запушен и красный на шумовой проверке. review-jam.t27 даёт Королеве один ответ. jam_case проверяет 9 фактов в постоянном порядке, и побеждает правило, совпавшее раньше остальных, так что PR, который Королева не смогла измерить, никогда не считается свободным, а отклонённый и затем запушенный не принимается за шум. Случаев 10, от none до unmeasured.

Попробовать

Снимайте факты по одному со стартового состояния и называйте каждый случай; затем найдите PR, который ни в каком заторе.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The review jam: which case a stuck pull request is in
The review jam: which case a stuck pull request is in ↗

Nine facts about a pull request that will not move. Toggle them: the earliest rule that matches wins, and the pull request lands on that rule.

specs/automation/review-jam.t27

// Review jam: which case a stuck pull request is in, and the Queen's action.
@@ -342,6 +374,7 @@ 

Затор ревью

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-ship-flies-home/index.html b/apps/website/public/ru/learn/the-ship-flies-home/index.html index cc84555460..85b9cf2d18 100644 --- a/apps/website/public/ru/learn/the-ship-flies-home/index.html +++ b/apps/website/public/ru/learn/the-ship-flies-home/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Корабль летит домой

Вы узнаете

Где игра рисует пчелу в каждом её занятии и как завершённая задача заканчивается на экране.

В игре на app.t27.ai/game каждая пчела — корабль над задачей, над которой она работает. ship_mode в hive.t27 выбирает место: стоянка у входа, пока раннер её не взял, облёт своей ячейки, пока от неё приходят вести, зависание, когда она замолчала, и ожидание у портала своего репозитория, пока ячейку не поставили. Когда пчела уходит из ленты, она летит домой, и ship_alpha гасит её за DEPART_MS, 2400 мс: через 1200 мс у неё 500 из 1000.

Попробовать

Отметьте, что от пчелы давно нет вестей, и посмотрите, куда она сдвинется; затем протяните время дальше 2400 мс.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The game: where a bee flies and how it leaves
The game: where a bee flies and how it leaves ↗

Set what the bee is doing and where its cell stands: ship_mode puts it at the entrance, the portal, its cell or on the way home, and ship_alpha fades it out.

specs/queen/hive.t27

// SPDX-License-Identifier: Apache-2.0
@@ -252,6 +284,7 @@ 

Корабль летит домой

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/the-sigmoid/index.html b/apps/website/public/ru/learn/the-sigmoid/index.html index 5e5a72d334..45f8152a9a 100644 --- a/apps/website/public/ru/learn/the-sigmoid/index.html +++ b/apps/website/public/ru/learn/the-sigmoid/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сигмоида: число в вероятность

Вы узнаете

Как сигмоида переводит любой вход в вероятность и почему её наклон мешает глубоким сетям.

Сигмоида 1 / (1 + e^-x) сжимает всю числовую прямую в отрезок от 0 до 1, поэтому её читают как вероятность: 2 превращается в 0.8808, а -4 в 0.018. Её наклон равен s (1 - s) и считается по самому выходу s; он наибольший в 0, где равен 0.25, а при x = 8 равен 0.000335. Градиент, который идёт назад через стопку сигмоид, на каждой умножается не больше чем на 0.25, поэтому глубокие сети на сигмоидах учились медленно. Спека sigmoid_activation.t27 вычисляет кривую и наклон.

Попробовать

Найдите вход, при котором вероятность равна 0.5; затем перетащите к 6 и посмотрите, как мало осталось наклона.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Sigmoid: turn any number into a probability
Sigmoid: turn any number into a probability ↗

Drag along the S-curve: every input lands between 0 and 1, and the slope peaks at 0.25 in the middle and dies away at both ends.

specs/ml/activation/sigmoid_activation.t27

// SPDX-License-Identifier: Apache-2.0
@@ -164,6 +196,7 @@ 

Сигмоида: число в вероятность

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/three-bots-deep/index.html b/apps/website/public/ru/learn/three-bots-deep/index.html index ecac973c0f..d63871a043 100644 --- a/apps/website/public/ru/learn/three-bots-deep/index.html +++ b/apps/website/public/ru/learn/three-bots-deep/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Три бота в глубину

Вы узнаете

Как улей не даёт агентам отвечать друг другу бесконечно.

Telegram не защищает ботов от зацикливания, так что два агента могли бы отвечать друг другу вечно. Это останавливают два числа. MAX_BOT_DEPTH равно 3: человек, затем A, B и C, затем тишина. BOT_REPLY_COOLDOWN_MS равно 5000: бот отвечает другому боту не чаще раза в 5 с. may_answer всегда пропускает человека, а бота — только внутри цепочки и после паузы.

Попробовать

Найдите промежуток, при котором агент B замолкает; затем объясните, почему молчит и C.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Chain depth: human, A, B, C, then silence
Chain depth: human, A, B, C, then silence ↗

One person asks; agents answer each other. Drag the pause between bot messages: may_answer lets the chain run three bot messages deep and then stops it.

specs/automation/agent-hive-group.t27

// SPDX-License-Identifier: Apache-2.0
@@ -429,6 +461,7 @@ 

Три бота в глубину

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/three-way-agreement/index.html b/apps/website/public/ru/learn/three-way-agreement/index.html index 6895e26f94..0875457fb6 100644 --- a/apps/website/public/ru/learn/three-way-agreement/index.html +++ b/apps/website/public/ru/learn/three-way-agreement/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Тройное согласие

Вы научитесь

Как spec, симулятор и плата приводятся к одному ответу и чему каждая сторона доверена.

Три ответа, один вопрос. Spec говорит, что должно случиться; симулятор — что делает модель кремния; плата — что делает сам кремний. Виджет — репетиция этого согласия с выключенной платой: 26 проверок, без платы, без RTL — чистая линия возвращает все квитанции без переспросов, 11 случаев потерь и сбоя восстанавливаются, а ложь, дубликат или ответ не тем ключом останавливают прогон. Когда все трое сходятся на стенде Artix-7 XC7A200T, спорить больше не о чем.

Попробуйте

Найдите 11 восстанавливающихся случаев в репетиции и три ответа, останавливающих прогон; затем скажите, кого из трёх (spec, симулятор, плата) охраняет каждый.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-batch-rehearsal · the batched wire protocol, rehearsed off-board
tri fpga-batch-rehearsal · the batched wire protocol, rehearsed off-board ↗

26 checks, no board, no RTL: a clean link returns every receipt with no retransmit, 11 loss and fault cases recover, and a lie, a duplicate or a wrong-key answer stops the run. self-test: PASS.

specs/tools/trios/tri/fpga-batch-cosim.t27

// SPDX-License-Identifier: Apache-2.0
@@ -105,6 +137,7 @@ 

Тройное согласие

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/three-way-jump/index.html b/apps/website/public/ru/learn/three-way-jump/index.html index 1ee313de0e..0aeefd35fc 100644 --- a/apps/website/public/ru/learn/three-way-jump/index.html +++ b/apps/website/public/ru/learn/three-way-jump/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Переход на три стороны

Вы узнаете

Почему одно троичное сравнение может ветвиться на три стороны.

Двоичная машина ветвится по флагу: чтобы различить «меньше», «равно» и «больше», ей нужно две проверки. Троичное сравнение отвечает одним тритом, поэтому одна команда может перейти в три стороны. Виджет сравнивает a и b по первому различному триту, подсвеченному золотым, и выбирает нужную цель. Машина следующего урока завершает свои циклы ровно таким переходом.

Попробовать

Заставьте переход пойти в каждую из трёх целей; затем найдите два числа, которые различаются только младшим тритом.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A three-way jump: one compare, three targets
A three-way jump: one compare, three targets ↗

Compare two registers once and jump on the trit: less, equal or greater. A binary machine needs two tests for the same branch.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Переход на три стороны

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/times-a-trit/index.html b/apps/website/public/ru/learn/times-a-trit/index.html index 26c3ac7899..6d47edfdb2 100644 --- a/apps/website/public/ru/learn/times-a-trit/index.html +++ b/apps/website/public/ru/learn/times-a-trit/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Умножить на один трит

Вы узнаете

Почему умножение на -1, 0 или +1 — это переключатель, а не умножитель.

У произведения на один трит три случая: +1 копирует число, 0 его обнуляет, -1 переворачивает каждый трит. trit_times() спеки — ровно такой переключатель, и умножения в нём нет. Поэтому троичные нейросети дёшевы в железе: весу -1, 0 или +1 нужен мультиплексор и инвертор, а не умножитель.

Попробовать

Умножьте 25 на каждый трит и сравните плитки; затем объясните, почему вес 0 ничего не стоит в железе.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Times one trit: copy, drop or flip
Times one trit: copy, drop or flip ↗

Multiplying by a trit needs no multiplier. By +1 the number is copied, by 0 dropped, by -1 every trit is flipped.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Умножить на один трит

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/timing-slack/index.html b/apps/website/public/ru/learn/timing-slack/index.html index 88fddced12..76afb103a4 100644 --- a/apps/website/public/ru/learn/timing-slack/index.html +++ b/apps/website/public/ru/learn/timing-slack/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Тайминг и запас

Вы узнаете

Что такое slack и как читать отчёт о тайминге путь за путём.

Slack — сколько времени остаётся на пути, когда кончается период такта. Положительный запас: путь достаточно быстрый. Отрицательный: на этой частоте дизайн не работает. Каждая полоса здесь — настоящий путь оттрассированного дизайна на 50 МГц, разбитый на логику и трассировку, худшие сверху. Найдите, куда уходит время на худшем пути.

Попробуйте

Нажмите на худший путь и сравните время логики со временем трассировки. В спеке у каждого clock_tree перекос 100 пс: найдите тест, где бюджет 50 пс не выдерживается, и тот, где 200 пс проходит.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Slack waterfall: every timing path of a routed design, worst first
Slack waterfall: every timing path of a routed design, worst first ↗

159 endpoints of a real nextpnr-xilinx run at 50 MHz as logic and routing waterfalls, checked bin by bin against nextpnr's log. Drop a --report JSON for yours.

specs/fpga/cts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -292,6 +324,7 @@ 

Тайминг и запас

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/tokens-that-burn/index.html b/apps/website/public/ru/learn/tokens-that-burn/index.html index c047af71ff..3521171b67 100644 --- a/apps/website/public/ru/learn/tokens-that-burn/index.html +++ b/apps/website/public/ru/learn/tokens-that-burn/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сгорающие токены

Вы узнаете

Когда сгорает партия токенов и какая партия тратится раньше.

Правило владельца от 2026-10-01: все деньги уходят в токены, а токены, не потраченные за месяц, сгорают, так что заплативший делает контент, а не копит токены. Каждая партия живёт MONTH_DAYS, 30 дней, и days_left отсчитывает её от дня зачисления. На 25-й день у пакета месяца с дня 0 осталось 5 дней, у стартового подарка с дня 3 — 8, у пополнения с дня 12 — 17. Тратится раньше та, что сгорит раньше.

Попробовать

Найдите день, когда сгорает пакет месяца; затем найдите последний день, когда остаётся хоть одна партия.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Tokens that burn: a month to spend them
Tokens that burn: a month to spend them ↗

Three batches of tokens, each burning 30 days after it lands. Drag today across two months: days_left counts down every batch, and the one that burns soonest is spent first.

specs/automation/token-wallet.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Сгорающие токены

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/tri-commands/index.html b/apps/website/public/ru/learn/tri-commands/index.html index f6742708a7..329fd5e02c 100644 --- a/apps/website/public/ru/learn/tri-commands/index.html +++ b/apps/website/public/ru/learn/tri-commands/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

tri: командная строка

Вы узнаете

Что делает tri test, как tri передаёт остальные слова t27c и какие команды у него свои.

В репозитории gHashTag/t27 scripts/tri — небольшая обёртка. tri test запускает набор проверок соответствия, t27c suite --repo-root .; слово, которого tri не знает, например gen или seal, передаётся t27c. Свои команды у него — audit, recall, frontier, lesson и help. Этот урок прочитал скрипт и не запускал его: нативный t27c собирается на машине с Linux, и этот курс не запускает его на вашей.

Попробуйте

Прочитайте таблицу и скажите, какие команды уходят в t27c, а какие остаются внутри tri.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 24: where a tri command goes
t27 basics 24: where a tri command goes ↗

Which tri commands run inside the script and which are handed to t27c, read from scripts/tri in gHashTag/t27. Lesson 24 of the t27 basics course.

specs/basics/24_tri_commands.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

tri: командная строка

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/trits/index.html b/apps/website/public/ru/learn/trits/index.html index 3d05ba6b2b..b2722f467f 100644 --- a/apps/website/public/ru/learn/trits/index.html +++ b/apps/website/public/ru/learn/trits/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Триты: минус один, ноль, один

Вы узнаете

Как трит записывается маленькой знаковой константой и почему 27 встречается повсюду.

У бита два значения, у трита три: минус один, ноль и один. Спека урока записывает их константами i8 NEG, ZERO и POS, как это делают учебные спеки t27. POS плюс NEG даёт ZERO. У трёх тритов 3 на 3 на 3 сочетаний, то есть 27: столько уроков в этом курсе и клеток в слове TRI-27.

Попробуйте

Напишите assert, что POS минус NEG равно 2, и проверьте, что он проходит.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 8: three values of a trit
t27 basics 8: three values of a trit ↗

The three values of a trit as t27 constants, and how three trits give 27 combinations. Lesson 8 of the t27 basics course.

specs/basics/08_trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -87,6 +119,7 @@ 

Триты: минус один, ноль, один

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/true-false-and-text/index.html b/apps/website/public/ru/learn/true-false-and-text/index.html index ff76e81226..145e65e01f 100644 --- a/apps/website/public/ru/learn/true-false-and-text/index.html +++ b/apps/website/public/ru/learn/true-false-and-text/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Истина, ложь и текст

Вы узнаете

Как объявить bool и str и с чем их может сравнить тест.

bool — это true или false. str — текст в двойных кавычках, и в нём могут стоять символы, которые в других местах t27 что-то значат, например точка с запятой или две косые: внутри кавычек это просто текст. Тест сравнивает bool и str через == и !=. Честное ограничение: проверка в этом браузере не останавливает строку, отданную константе u8, так что следите за типами сами.

Попробуйте

Поменяйте NAME в спеке урока и поправьте тест, чтобы он снова прошёл.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 6: bool and str
t27 basics 6: bool and str ↗

The two non-number types of t27 in one table, with what a test can do with them. Lesson 6 of the t27 basics course.

specs/basics/06_true_false_and_text.t27

// SPDX-License-Identifier: Apache-2.0
@@ -84,6 +116,7 @@ 

Истина, ложь и текст

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/twice-the-cost/index.html b/apps/website/public/ru/learn/twice-the-cost/index.html index 2a88db9a1a..1951111827 100644 --- a/apps/website/public/ru/learn/twice-the-cost/index.html +++ b/apps/website/public/ru/learn/twice-the-cost/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Вдвое дороже цены

Вы узнаете

Как проект назначает цену операции и что покупает месяц токенов.

Каждый доллар становится токенами по одному курсу, TOKEN_MICRO_USD 5000: токен — полцента. price_tokens продаёт операцию вдвое дороже её стоимости, MARKUP_PCT 200, и округляет вверх, чтобы ничего не продавалось дешевле: стоимость 12300 микродолларов — это 5 токенов. month_tokens превращает $20 в 4000 токенов, то есть 14 рилсов по 270 токенов или 333 портрета по 12.

Попробовать

Найдите стоимости, которые дают ровно 1 токен; затем найдите месячную цену, на которую выходит 36 рилсов.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

The price of an operation: twice its cost, rounded up
The price of an operation: twice its cost, rounded up ↗

Drag what an operation costs the project and what a person pays a month: price_tokens sells it at twice the cost in half-cent tokens, and month_tokens turns dollars into tokens.

specs/automation/token-wallet.t27

// SPDX-License-Identifier: Apache-2.0
@@ -207,6 +239,7 @@ 

Вдвое дороже цены

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/twiddles-and-bit-reversal/index.html b/apps/website/public/ru/learn/twiddles-and-bit-reversal/index.html index bce67fefe7..b9325cb1f9 100644 --- a/apps/website/public/ru/learn/twiddles-and-bit-reversal/index.html +++ b/apps/website/public/ru/learn/twiddles-and-bit-reversal/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Поворачивающие множители и бит-реверс

Вы узнаете

Почему БПФ с прореживанием по времени берёт вход в бит-реверсном порядке и откуда берутся поворачивающие множители.

Разбейте вход на чётные и нечётные отсчёты, затем разбейте каждую половину снова, и порядок, в котором вы в итоге их читаете, — индекс с битами в обратном порядке. На 8 точках индекс 1 — это 001, и он уходит на место 4, а 3 — это 011, и он уходит на место 6. Двойное обращение возвращает индекс, поэтому перестановка — набор обменов, которому не нужна арифметика, только проводка. Поворачивающие множители W — точки единичной окружности, cos минус j sin. Спека signals.t27 вычисляет и то и другое.

Попробовать

На 16 точках найдите все индексы, которые остаются на месте; затем выберите индекс и прочитайте его поворачивающий множитель.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Bit reversal: the order an FFT reads its input in
Bit reversal: the order an FFT reads its input in ↗

Pick a size and an index: its bits read backwards give the place it takes at the input of a radix-2 FFT. See the whole crossing pattern at once.

specs/fpga/dsp/signals.t27

// SPDX-License-Identifier: Apache-2.0
@@ -1120,6 +1152,7 @@ 

Поворачивающие множители и бит-реверс

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/two-bits-per-trit/index.html b/apps/website/public/ru/learn/two-bits-per-trit/index.html index f52895b0fe..62450ed4c1 100644 --- a/apps/website/public/ru/learn/two-bits-per-trit/index.html +++ b/apps/website/public/ru/learn/two-bits-per-trit/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Два бита на трит

Вы узнаете

Во что обходится хранить трит в двоичной памяти простым способом.

Двоичная память хранит трит в двух битах: -1 как 00, 0 как 01, +1 как 10, так упаковывают триты аппаратные спеки этого репозитория. Код 11 ничего не значит. Трит несёт log2(3) = 1.585 бита информации, поэтому два бита заняты на 79.25%: пятая часть памяти не несёт ничего.

Попробовать

Выберите каждый трит и прочитайте его код; скажите, что декодеру делать с 11, и проверьте, что делает decode2() спеки.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

A trit in two bits, and the code nobody uses
A trit in two bits, and the code nobody uses ↗

Binary hardware stores a trit in two bits: -1 as 00, 0 as 01, +1 as 10. The fourth code, 11, means nothing: a quarter of the codes are wasted.

specs/ternary/trits.t27

// SPDX-License-Identifier: Apache-2.0
@@ -767,6 +799,7 @@ 

Два бита на трит

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/two-flop-sync/index.html b/apps/website/public/ru/learn/two-flop-sync/index.html index 712a6652a9..e862e1a65f 100644 --- a/apps/website/public/ru/learn/two-flop-sync/index.html +++ b/apps/website/public/ru/learn/two-flop-sync/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Двухтриггерный синхронизатор

Вы узнаете

Почему два триггера — это лекарство и как выглядит сгенерированная модель пересечения.

Лекарство — два триггера на такте приёмника, между ними ничего: ведущий может уйти в метастабильность, а второй снимает его устоявшийся выход целый период спустя. Каждая дополнительная ступень умножает MTBF на 2 в степени T_clk, умноженное на log2 e и делённое на tau, — 295400 в Q10 на 100 МГц, это stage_gain_q10() спеки. Запись показывает t27c gen на clock_domain.t27: напечатанный Zig — модель пересечения, на которую опирается весь курс, и wc -l её считает. Цена двух триггеров — задержка: пара тактов приёмника от фронта до устоявшегося выхода, та же цена, которую платит конвейер снятия из модуля 4.

Попробуйте

В записи найдите wc -l сгенерированной модели; затем в окне спеки найдите стратегию two_flop и скажите, какой модуль её разбирал.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c gen on clock_domain.t27 -- the CDC model as Zig
t27c gen on clock_domain.t27 -- the CDC model as Zig ↗

t27c gen prints the clock-domain model it compiled, and wc -l says how many lines of Zig it is.

specs/fpga/clock_domain.t27

// SPDX-License-Identifier: Apache-2.0
@@ -298,6 +330,7 @@ 

Двухтриггерный синхронизатор

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/two-products-one-sum/index.html b/apps/website/public/ru/learn/two-products-one-sum/index.html index 0f37312e5a..357a5d92fb 100644 --- a/apps/website/public/ru/learn/two-products-one-sum/index.html +++ b/apps/website/public/ru/learn/two-products-one-sum/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Два произведения, одна сумма

Вы узнаете

Как умножение с накоплением в GF-T16 считает a1 * b1 + a2 * b2, ядро умножения матриц.

Каждый слой сети — стопка скалярных произведений, а скалярное произведение — сложенные произведения. gft_dot2.t27 — самое маленькое: y = a1 * b1 + a2 * b2 в GF-T16, 16-битной величине из 7-битного смещения и 9-битной мантиссы со смещением 40. В такой раскладке 1.0 — это код 20480, а 2.0 — код 20992. В спеке два теста: 1 * 1 = 1 и 1 * 1 + 1 * 1 = 2.

Попробуйте

Найдите оба теста и раскодируйте 20480 и 20992 вручную по value = (1 + mant / 512) * 2^(offset - 40). Затем найдите строку в gft_mul, которая обрабатывает перенос, когда произведение переходит 2.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 14: two products, one sum
GoldenFloat 14: two products, one sum ↗

The two tests of gft_dot2.t27, read from gft_dot2.t27. Lesson 14 of the GoldenFloat course.

specs/ternary/gft_dot2.t27

module GftDot2;
@@ -143,6 +175,7 @@ 

Два произведения, одна сумма

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/two-to-the-x/index.html b/apps/website/public/ru/learn/two-to-the-x/index.html index 99cddcfeb0..5777e69fc7 100644 --- a/apps/website/public/ru/learn/two-to-the-x/index.html +++ b/apps/website/public/ru/learn/two-to-the-x/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Два в степени x

Вы узнаете

Как exp2 делит x на целую часть и дробь и почему её тесты доходят только до целой части.

Заголовок gft_exp2.t27 называет exp2 недостающим кирпичиком для softmax на GF-T. on_comb делит x на целую часть k и дробь f: k задаёт смещение, k + 40, а pow2_frac превращает f в мантиссу. Заголовок обещает ошибку не больше 1 ULP, измеренную в прототипе, но все 4 теста подают целые входы, 0, 1.0, -1.0 и 2.0, поэтому f равна 0, и pow2_frac возвращает 0 при любых коэффициентах. Браузер пропускает все 4 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который теряет минус у k для отрицательного x, и снова t27c test-report: падает ровно один тест, em1: 2^-1 выходит как 2.0, а не 0.5. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и значение, которого ждёт em1; затем найдите в спеке pow2_frac и выясните, что она возвращает, когда f равна 0.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_exp2.t27 -- two to the x, native
t27c on gft_exp2.t27 -- two to the x, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; dropping the minus sign of k makes exactly one test fail, em1; git restores the spec.

specs/ternary/gft_exp2.t27

module GftExp2;
@@ -135,6 +167,7 @@ 

Два в степени x

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/use-other-modules/index.html b/apps/website/public/ru/learn/use-other-modules/index.html index c073e8bc94..e93104cbe3 100644 --- a/apps/website/public/ru/learn/use-other-modules/index.html +++ b/apps/website/public/ru/learn/use-other-modules/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Другие модули

Вы узнаете

Как пишется строка use и что браузер может и чего не может с ней сделать.

use base::types; называет модуль по пути, части разделены ::. Парсер читает это как объявление use. У компилятора в вашем браузере нет копии других файлов, поэтому он не открывает base::types и не проверяет имена, которые оттуда приходят. Нативный t27c разрешает импорты из репозитория; этот урок не мог выполнить такую проверку здесь.

Попробуйте

Найдите объявление use в дереве разбора спеки урока в плеере.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 19: what a use line does in the browser
t27 basics 19: what a use line does in the browser ↗

A t27 use line, how the parser reads it, and what the browser compiler leaves unchecked. Lesson 19 of the t27 basics course.

specs/basics/19_use_other_modules.t27

// SPDX-License-Identifier: Apache-2.0
@@ -81,6 +113,7 @@ 

Другие модули

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/vcd-format/index.html b/apps/website/public/ru/learn/vcd-format/index.html index c5229998a5..5ffb01df1c 100644 --- a/apps/website/public/ru/learn/vcd-format/index.html +++ b/apps/website/public/ru/learn/vcd-format/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Формат VCD

Вы научитесь

Что на самом деле лежит в .vcd-файле и как читать его дамп всех сигналов.

Файл временной диаграммы — это текст, и читать его как текст — навык. .vcd объявляет масштаб времени, называет области и переменные, а дальше записывает только изменения: метка времени, идентификатор, значение. Spec урока, vcd_trace, моделирует именно это — заголовки, изменения, длительности — с тестами на самое раннее и самое позднее изменение. Виджет — настоящая трасса, завёрнутая в карточку: тестбенч переключил clk 585 раз и оставил 4 сигнала в X на всём прогоне; оба факта посчитаны из файла, а не вспомнены с экрана.

Попробуйте

Прочитайте карточку обёрнутой трассы: 585 переключений, 4 сигнала в X; затем найдите в vcd_trace функцию, считающую изменения в одной метке времени.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

VCD wrapped: your simulation, summed up on one card
VCD wrapped: your simulation, summed up on one card ↗

Drop a .vcd from any simulator and get a Wrapped-style card: value changes, the busiest net, signals stuck at X or Z, the quietest ones and the time span, read in your browser.

specs/fpga/vcd_trace.t27

// SPDX-License-Identifier: Apache-2.0
@@ -360,6 +392,7 @@ 

Формат VCD

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/verify-capstone/index.html b/apps/website/public/ru/learn/verify-capstone/index.html index fdcd3d5072..f1e85b5f81 100644 --- a/apps/website/public/ru/learn/verify-capstone/index.html +++ b/apps/website/public/ru/learn/verify-capstone/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Капстоун: проверить модуль целиком

Вы научитесь

Провести один модуль от spec до платы со всем проверочным стеком за спиной.

Один модуль, весь стек. Проведите дизайн через плеер (spec чист), тестбенч (проверки исполнены, а не пропущены), векторы (ответы рядом со входами), косимуляцию (spec, симулятор и плата сходятся на стенде Artix-7 XC7A200T), покрытие (строки, переключения, дуги, запретные дуги холодны), формальные методы (ассерты проверены ограниченно, индукция попытана честно), мутации (счёт убитых на посаженных неисправностях) и приёмку (одна команда, все квитанции). Виджет — этот поток по-настоящему: размещение, трассировка, загруженный битстрим, такт на экране. Ничто в этом курсе — не шаг, который вы перерастёте.

Попробуйте

Выберите собственный модуль и запишите его план проверки: векторы, проверки тестбенча, цели покрытия, ассерты, мутанты, приёмка; затем прогоните виджет потока от начала до конца и отметьте, где ваш план остановил бы настоящий баг.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Place and route to a loaded bitstream, timed
Place and route to a loaded bitstream, timed ↗

router1, bitwalk, xc7frames2bit, SRAM load: 19.06 s here, on a laptop at load average ~110.

specs/fpga/testbench/integration_tb.t27

// SPDX-License-Identifier: Apache-2.0
@@ -200,6 +232,7 @@ 

Капстоун: проверить модуль целиком

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/verify-hardware/all/card.png b/apps/website/public/ru/learn/verify-hardware/all/card.png new file mode 100644 index 0000000000000000000000000000000000000000..81f990dfea8a89a4c096876dfebd7d0a2dd6ba6a GIT binary patch literal 56299 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Πc}c@u4OVmrN*Y)uHEV7ibG-kbnK)1K{=3x`sxPn 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 U&z1k6KfzFxQ@~ literal 0 HcmV?d00001 diff --git a/apps/website/public/ru/learn/verify-hardware/all/index.html b/apps/website/public/ru/learn/verify-hardware/all/index.html new file mode 100644 index 0000000000..595100bac7 --- /dev/null +++ b/apps/website/public/ru/learn/verify-hardware/all/index.html @@ -0,0 +1,482 @@ + + + + + + +Проверка железа с t27: тестбенчи, временные диаграммы, формальные методы, мутации: весь курс на одной странице · t27 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

t27.ai
+
+ +
+
+

Курс · Весь курс на одной странице

+

Проверка железа с t27: тестбенчи, временные диаграммы, формальные методы, мутации

+

Для читателя, у которого есть дизайн и который хочет ему доверять. Каждый урок открывает настоящий инструмент проверки, собранный из реальных прогонов на нашем стенде: немного почитать, потом сломать что-нибудь нарочно.

+

27 уроков, в каждом работающий виджет и один spec t27: самопроверяющиеся тестбенчи, временные диаграммы, векторы, косимуляция с платой, покрытие, ассерты, мутационное тестирование и приёмка, которую можно показать.

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

+
Поделиться курсомXTelegramLinkedIn
+ +

0 из 27 пройдено

+

Открыть интерактивный курс →

+
+

Модуль 1 · Зачем проверять

Дизайны, которые компилируются и ошибаются; модель, которая выносит вердикт; план, записанный до кода.

+
+
01

Урок 1 из 27

Баги, которые компилируются

+
+

Вы научитесьПочему чистая компиляция доказывает так мало и чего стоит печать без вывода.

Всё здесь компилируется. Тестбенч UART в плеере зелёный на всех семи бэкендах — и всё же он почти ничего не доказывает: компиляция говорит, что слова разбираются и типы сходятся, а не что вы имели в виду именно эти слова. Виджет показывает ловушку покрупнее: у каждого слитого spec в t27 есть печать — хэш того, что произвела сборка; 31 из 1,428 печатей не записывают вывода вовсе, на 16 spec, и 3 из них нет в журнале долгов, который обязан их называть. Печать без вывода — зелёная галочка, под которой пусто; проверка начинается ровно здесь.

Попробуйте

Откройте разбор печатей и найдите 16 spec без вывода; затем откройте uart_tb в плеере и скажите вслух, чего не доказывает его компиляция.

+
tri seals: hollow seals that pass every checkВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/uart_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
02

Урок 2 из 27

Золотая модель

+
+

Вы научитесьЧто такое эталонная модель и как набор соответствия держит инструмент в рамках.

Чтобы судить об реализации, нужен ответ, который из неё не пришёл: золотая модель. Для числового формата это таблица из статьи; для инструмента — эталон, на соответствие которому он заявлен. Виджет — это прогон соответствия для собственного FPGA-инструментария t27: 17 из 17 spec соответствия компилируются, их тест-блоки проходят, и ни один сгенерированный файл не разошёлся с зафиксированным. Spec урока — каркас, общий для всех этих тестбенчей: формы, которые тестбенч обязан иметь, прежде чем сможет что-то проверять.

Попробуйте

Откройте tri-fpga-specs и прочитайте тест-блоки одного spec соответствия; затем откройте testbench.t27 и назовите четыре формы, которые обязан иметь тестбенч.

+
tri fpga-specs: every board spec, compiled and testedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
03

Урок 3 из 27

Сначала план

+
+

Вы научитесьКак план проверки превращается в чек-лист, который команда может прогнать и подписать.

План тестов, записанный после кода, — описание того, что код делает; записанный до кода — требование, которому код обязан соответствовать. В этом репозитории план — это spec, и одна команда его прогоняет. Виджет — такой прогон для инструментов стенда: 14 из 14 проходят собственные самопроверки за один проход — decode 18/18, repin 17/17 — а инструмент, который не может себя проверить, попадает в список, а не в зачёт. Spec урока — build_verify: чек-лист того, что сборка обязана показать, прежде чем кто-то назовёт её готовой.

Попробуйте

Запустите прогон инструментов и найдите инструмент, чья самопроверка перечислена, а не исполнена; затем прочитайте чек-лист build_verify и отметьте, какие пункты — счётчики, а какие — заявления.

+
tri fpga-tools · 14 bench tools test themselvesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/verification/build_verify.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 2 · Тестбенчи

Стимулы, проверки и вердикт, записанные как один spec рядом с дизайном, который они судят.

+
+
04

Урок 4 из 27

Анатомия тестбенча

+
+

Вы научитесьИз чего состоит каждый *_tb.t27: стимулы, ожидания, проверки, вердикт.

Каждый тестбенч в этом репозитории — один .t27-файл с одним и тем же скелетом, и плеер компилирует его как любой другой spec. Откройте fifo_tb: он строит стимулы (байты в FIFO), ожидания (те же байты по порядку), проверки (по одному ассерту на инвариант, чтобы провал называл именно нарушенный) и вердикт (счёт, а не ощущение). Виджет генерирует JavaScript из spec прямо в браузере и запускает его — та же связка «сгенерировать и исполнить», на которой стоит тестбенч, причём достаточно маленькая, чтобы увидеть её целиком.

Попробуйте

Сгенерируйте JavaScript для spec fifo_tb в плеере и запустите его; найдите ассерт, который упал бы раньше остальных, если бы FIFO терял байт.

+
hello_world.t27 to JavaScript, in a terminal inside the postВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/fifo_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
05

Урок 5 из 27

Самопроверка вместо всматривания

+
+

Вы научитесьКак написать тестбенч, который падает громко, и почему разглядывание волн — не проверка.

Тестбенч, который печатает волны и останавливается, — машина по производству всматривания. Самопроверяющийся тестбенч вычисляет вердикт и выходит с ненулевым кодом при провале, поэтому скрипт может прогнать тысячу таких и доверять коду возврата. Виджет — терминал для семи бэкендов t27: каждая команда прогнана на hello_world, 21 прошла, 0 упало — и каждый проход заработан ассертом, который исполнился, а не фактом завершения. Spec урока, spi_tb, заканчивается так же: счёт проверок и режим отказа, который нельзя принять за успех.

Попробуйте

Откройте терминал семи бэкендов и найдите команду, чей проход не исполнил ни одного ассерта; затем найдите в spi_tb режим отказа, который не может напечатать «ok».

+
t27 play · the terminal's own gatesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/spi_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
06

Урок 6 из 27

Направленные против случайных

+
+

Вы научитесьКогда один выбранный случай стоит тысячи случайных, а когда нет.

Направленный тест — один случай, выбранный потому, что вы знаете: он кусается. Пустой FIFO, полный FIFO, переход через границу. Случайный тест — дешёвый объём. Это не соперники, это последовательность. Виджет — эксперимент-нокдаун, превращённый в инструмент: заявлены три бита производительности, и на каждый бит собран отдельный битстрим-нокдаун — тот же дизайн с выключенным битом, — доказывающий, что бит важен. В этом весь аргумент направленных тестов: один бит, один прогноз, один битстрим, одно измерение.

Попробуйте

Выберите один бит производительности в виджете-нокдауне и скажите, что должен показать прогон без нокдауна, чтобы бит оказался ложью.

+
Three PERF2 bits, and one knockout bitstream per bitВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/uart_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 3 · Временные диаграммы

Трасса каждого сигнала, прочитанная так, как её читает инженер по железу, и два прогона, сравнённые между собой.

+
+
07

Урок 7 из 27

Формат VCD

+
+

Вы научитесьЧто на самом деле лежит в .vcd-файле и как читать его дамп всех сигналов.

Файл временной диаграммы — это текст, и читать его как текст — навык. .vcd объявляет масштаб времени, называет области и переменные, а дальше записывает только изменения: метка времени, идентификатор, значение. Spec урока, vcd_trace, моделирует именно это — заголовки, изменения, длительности — с тестами на самое раннее и самое позднее изменение. Виджет — настоящая трасса, завёрнутая в карточку: тестбенч переключил clk 585 раз и оставил 4 сигнала в X на всём прогоне; оба факта посчитаны из файла, а не вспомнены с экрана.

Попробуйте

Прочитайте карточку обёрнутой трассы: 585 переключений, 4 сигнала в X; затем найдите в vcd_trace функцию, считающую изменения в одной метке времени.

+
VCD wrapped: your simulation, summed up on one cardВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/vcd_trace.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
08

Урок 8 из 27

Отладка по волнам

+
+

Вы научитесьКак пройти от симптома к сигналу, такт за тактом, на настоящем измеренном баге.

Вот баг, найденный волнами, от начала до конца. Линк UART на стенде запросил 115,200 бод, а провод нёс 115,385 — ошибку +0.16 % от делителя частоты, невидимую в коде и очевидную в захвате. Запрошено 921,600 — провод несёт 923,077, та же дробная ошибка; 3,000,000 делится нацело и на проводе точно. Измерение называет исправление: брать делители, дающие целые частоты. Волны превращают симптом (потерянные байты) в число (0.16 %) и в правку.

Попробуйте

Посчитайте, какой делитель положил бы 115,200 на провод точно; сверьте с рядами 921,600 и 3,000,000 в виджете.

+
tri fpga-wire · the baud rate actually on the wireВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/vcd_trace_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
09

Урок 9 из 27

Сравнение двух трасс

+
+

Вы научитесьКак сравнить два прогона и пусть трасса назовёт самый ранний такт расхождения.

Два прогона одного тестбенча, до изменения и после: самый быстрый вопрос — где они разошлись. Диф по трассе отвечает с точностью до одного изменения сигнала: самый ранний такт, где эталонный прогон говорит 1, а новый говорит 0. Виджет сравнивает файлы именно так, кадр за кадром, и отказывается говорить «одинаково», когда байт различается. Spec урока — тестбенч, ведущий инструмент сравнения VCD: ожидание против факта, с печатью несовпадения, а не разглядыванием.

Попробуйте

Откройте диф на двух собственных файлах; затем найдите в тестбенче сравнения место, где печатается самый ранний несовпадающий такт.

+
Bitstream diff: two 7-series .bit files, frame by frameВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/vcd_conformance_compare_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 4 · Векторы соответствия

Случаи с ответом, записанным рядом, там, откуда их достанет компилятор.

+
+
10

Урок 10 из 27

Что такое вектор

+
+

Вы научитесьЧто такое тест-вектор и почему ответ должен лежать рядом со входом, в файле.

Вектор — это вход с корректным выходом, записанным рядом, в файле, который инструмент может прочесть. Именно на последнем условии векторы обычно и умирают: в корпусе живут 34 векторных файла с 512 случаями, и прогон за виджетом посчитал: 2 файла реально исполнены, 8 записаны как долг, 24 — только проза, описания случаев, которые ни один раннер не разберёт. 19% несут данные. Вектор, который ничто не исполняет, — документация в одежде тестбенча.

Попробуйте

Посчитайте в переписи виджета векторные файлы, которые ни один раннер не исполняет; затем запишите один вектор, с ответом, в файл, который инструмент сможет разобрать.

+
tri vectors debt: tests that are proseВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/numeric/formats_catalog.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
11

Урок 11 из 27

Векторы как эталонная линейка

+
+

Вы научитесьКак каталог работает линейкой: каждая популяция пересчитана, каждый счёт сходится.

Линейка работает, только если не растягивается. Каталог форматов — линейка t27 для числовых форматов, а виджет — проверка самой линейки: четыре переписные популяции, посчитанные в каталоге и пересчитанные другим способом, сходятся все, а три, которые проверить нельзя, названы непроверяемыми, а не подогнаны под согласие. Вот образец, который стоит копировать: пересчитывайте каждый счёт вторым способом и публикуйте те, что не пересчитались.

Попробуйте

Откройте виджет переписи и назовите три популяции, помеченные непроверяемыми; затем найдите в каталоге форматов счёт, названный дважды.

+
tri census audit: every census, counted twiceВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/numeric/formats_catalog.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
12

Урок 12 из 27

Сквозные сценарии

+
+

Вы научитесьКак сценарий проходит весь поток и что сквозной прогон доказывает, чего не могут юниты.

Юнит-тесты проверяют детали; сценарий проверяет трубу. Spec урока, e2e_demo, проводит один дизайн от spec до платы за один прогон, поэтому сбой в любом месте цепи падает в одной точке с именем. Виджет рисует весь FPGA-поток по слою на строку — spec, Verilog, ячейки, размещение, битстрим, плата — и сквозной сценарий — ровно эта картинка, превращённая в тест: каждый слой либо производит свой артефакт, либо останавливает прогон.

Попробуйте

Пройдите по виджету потока слой за слоем и назовите артефакт каждого слоя; затем найдите в e2e_demo место, где пропавший артефакт останавливает прогон.

+
tri devkit · the FPGA flow, layer by layerВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/e2e_demo.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 5 · Косимуляция

Spec, симулятор и плата сходятся в одном ответе на стенде Artix-7 XC7A200T, и что делать, когда не сходятся.

+
+
13

Урок 13 из 27

Тройное согласие

+
+

Вы научитесьКак spec, симулятор и плата приводятся к одному ответу и чему каждая сторона доверена.

Три ответа, один вопрос. Spec говорит, что должно случиться; симулятор — что делает модель кремния; плата — что делает сам кремний. Виджет — репетиция этого согласия с выключенной платой: 26 проверок, без платы, без RTL — чистая линия возвращает все квитанции без переспросов, 11 случаев потерь и сбоя восстанавливаются, а ложь, дубликат или ответ не тем ключом останавливают прогон. Когда все трое сходятся на стенде Artix-7 XC7A200T, спорить больше не о чем.

Попробуйте

Найдите 11 восстанавливающихся случаев в репетиции и три ответа, останавливающих прогон; затем скажите, кого из трёх (spec, симулятор, плата) охраняет каждый.

+
tri fpga-batch-rehearsal · the batched wire protocol, rehearsed off-boardВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/tools/trios/tri/fpga-batch-cosim.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
14

Урок 14 из 27

Внутри симулятора

+
+

Вы научитесьЧто симулятор хранит (состояние) и чего не хранит (время между событиями).

Симулятор — это состояние плюс очередь событий, и знание этого делает его вывод заслуживающим доверия. Spec урока, simulator, моделирует сам движок: состояния, точки наблюдения, записи трассы и цикл, разбирающий события по порядку. Виджет читает настоящий стенд так, как симулятор держит состояние: кабели, платы, блокировки и последние прогоны на плате — три прогона x7-board PASS 51840/51840 — одна команда, один снимок, без пересказов между делом.

Попробуйте

Найдите в simulator.t27 цикл, разбирающий события, и скажите, что он сделает, если два события поделят одну метку времени; затем сравните с одним снимком статуса в виджете.

+
tri fpga-status · the bench at a glanceВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/simulator.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
15

Урок 15 из 27

Когда они не сходятся

+
+

Вы научитесьКак разбирать расхождение: кто из трёх врёт и как это узнать.

Когда spec, симулятор и плата расходятся, один из них врёт, и само расхождение подсказывает, где искать. Если симулятор сходится со spec, а плата отличается, подозревайте ограничения, тайминг или допущения модели — начинайте с назначений пинов: они лгут чаще всего. Виджет — инструмент триажа ровно для этого класса: перед правкой Verilog-файла он перечисляет каждый spec и генератор, которых правка коснётся, чтобы фикс не уполз молча. Сначала широта (что меняется?), потом глубина (почему именно это?).

Попробуйте

Составьте список триажа: для каждого направления расхождения (spec против симулятора, симулятор против платы) назовите файл, который вы откроете раньше прочих, и почему.

+
tri fpga-pins · the blast radius of an edit, before the editВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/tools/trios/tri/fpga-batch-cosim.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 6 · Покрытие

Чего коснулись тесты: строки, переключения, состояния — и что прячет это число.

+
+
16

Урок 16 из 27

Строки и переключения

+
+

Вы научитесьКак построчное покрытие и покрытие переключений считают, чего прогон коснулся, бит за битом.

Построчное покрытие спрашивает: исполнялась ли эта строка? Покрытие переключений спрашивает острее, по битам: этот сигнал когда-нибудь шёл из 0 в 1, а когда-нибудь из 1 в 0? Застрявший сигнал может всю жизнь просидеть под 100 % построчного покрытия. Spec урока — coverage.t27: точки со счётчиками срабатываний, проценты по видам и запретные дуги, обязанные оставаться на нуле, — с 26 тестами и 4 инвариантами собственной персоной. Виджет показывает полосами ресурсы настоящего дизайна; полосы покрытия — та же картинка, только по тому, чего прогон коснулся.

Попробуйте

Посчитайте точки в тесте fsm_report из coverage.t27 и проверьте процент вручную; затем найдите в виджете ресурсов сигнал, который счётчик переключений пометил бы.

+
Resource bars: LUT, FF, BRAM and DSP used on the XC7A200TВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/coverage.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
17

Урок 17 из 27

Покрытие автоматов

+
+

Вы научитесьКак покрытие состояний и переходов видит дуги, по которым прогон так и не прошёл.

Автомат проверяется дугами, а не состояниями: 4 состояния с 12 переходами — это 12 способов ошибиться, и обход всех состояний может оставить половину дуг холодными. Spec моделирует это прямо: точки состояний и точки переходов, каждая со счётчиком, и запретные переходы, ломающие отчёт в тот момент, когда хоть один согреется. Виджет — та же дисциплина в другой форме: 112 файлов закреплены в spec по sha256, каждый учтён — 0 потеряно, 0 не сохранено, 0 не найдено. Ничему в списке не разрешено остаться непосещённым.

Попробуйте

Перечислите дуги автомата FIFO из 4 состояний и отметьте, какие оставит холодными нагрузка только на чтение; затем найдите в spec запретные дуги и то, что их согревает.

+
tri fpga-tmpcheck · every /tmp file a spec pins, keptВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/coverage.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
18

Урок 18 из 27

Покрытие лжёт

+
+

Вы научитесьПочему процент покрытия бывает проверкой, которая ничего не проверила, и как это распознать.

Процент покрытия — заявление о тестах, и заявления бывают пустыми. Виджет нашёл пустой вид: 11 spec отвергнуты на разборе, 0 заблокированы только прозой, и 23 сломаны нарочно как фикстуры — но где-то ещё в корпусе «тест», являющийся только прозой, проходит все проверки, ничего не исполняя. Приметы всегда одни: число без знаменателя, проход без исполнившегося ассерта, прогон, который не может упасть. Спрашивайте с каждого процента: что сдвинуло бы это число?

Попробуйте

В прогоне по прозе найдите разницу между «отвергнут на разборе» и «заблокирован только прозой»; затем напишите тест, чей проход не исполняет ни одного ассерта.

+
tri prose report: prose, or code?Виджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/fifo_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 7 · Формальные методы

Ассерты, верные каждый такт; ограниченный поиск контрпримера; и почему доказательству нужна индукция.

+
+
19

Урок 19 из 27

Ассерты

+
+

Вы научитесьЧто такое ассерт в коде и сколько стоит проверять его каждый такт.

Ассерт — это проверка, которая остаётся в дизайне, каждый такт, навсегда: не тестбенч, исполняющийся однажды, а утверждение о железе, обязанное выполняться, пока железо работает. Spec урока, formal, записывает их как данные — немедленные и параллельные, серьёзность, названные такт и сброс, — потому что ассерт, который нельзя перечислить, нельзя и погасить. Виджет — та же идея на пороге: каждая зависимость, нужная инструменту, присутствует или нет, проверяется одним вызовом до всякого запуска.

Попробуйте

Запишите один немедленный и один параллельный ассерт для FIFO с названными тактом и сбросом; затем посмотрите в виджете зависимостей, что сам tri предполагает имеющимся.

+
tri selftest: the dependencies tri needsВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/formal.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
20

Урок 20 из 27

Ограниченная проверка моделей

+
+

Вы научитесьКак ограниченный перебор исследует все входы до k тактов и что это доказывает.

Ограниченная проверка моделей — исчерпывающий поиск с горизонтом: все входы, все состояния, до k тактов — находится ли среди них нарушающий ассерт? Внутри границы это доказательство, а не выборка; никакой случайный сид не пропустит то, что перебор перечисляет. Spec урока несёт форму: глубина, таймаут, свойства для проверки. Виджет — ограниченный поиск в другой области: 84 журнала плат и моделей просмотрены в поисках ключа, которого нигде не должно быть, — 0 находок, 0 журналов, которые слишком велики, чтобы их прочесть, — отсутствие, проверенное перебором, а не предположенное.

Попробуйте

Назначьте глубину k и скажите точно, что ваш BMC-прогон доказывает и чего нет; затем найдите в прогоне по ключу, чего стоило «0 находок», чтобы быть проверенным, а не предположенным.

+
tri fpga-keycheck: the key is counted, never printedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/formal.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
21

Урок 21 из 27

Индукция

+
+

Вы научитесьПочему ограниченность — не доказательство и как индукция закрывает разрыв — или честно сообщает, что не может.

Ограниченность значит ограниченность: k проверенных тактов — это всё, что k доказывает. Чтобы закрыть разрыв, нужна индукция — предположить, что инвариант держался до такта k, и показать, что он держится на такте k+1, — и индукция честна так, как ограниченный перебор не бывает: она может не получиться, и неуспех индукции — находка, а не конфуз. Виджет показывает, как выглядит непогашенное обязательство, на которое никто не смотрит: 12 файлов Lean, 15,553 строки и 4 sorry, до которых не добирается ни один корень сборки — ничто их не компилирует, значит доказательства в них никогда не проверялись. Обязательство, до которого не добирается ни один корень, не погашено — оно припарковано.

Попробуйте

Найдите 4 sorry в прогоне по Lean и скажите, что изменил бы корень сборки, который до них добирается; затем назовите инвариант uart_tb, который попробовали бы доказать индукцией.

+
tri lean: proofs that nothing compilesВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/formal_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 8 · Мутации

Ломайте дизайн нарочно и считайте, что заметили тесты.

+
+
22

Урок 22 из 27

Убить мутанта

+
+

Вы научитесьКак мутационное тестирование переворачивает игру: ломайте дизайн нарочно и смотрите, заметят ли тесты.

Мутационное тестирование переворачивает всю игру: вместо вопроса «проходят ли тесты» — сломайте дизайн нарочно и спросите, заметили ли тесты. Виджет — инструмент, делающий это с трактом битстрима: посадить баг и смотреть, как тесты его ловят, а spec урока — команда, которой принадлежит посадка. Набор тестов, который всё проходит и не ловит ни одного мутанта, — набор, который не может упасть, а набор, который не может упасть, ничего не охраняет.

Попробуйте

Посадите баг инструментом мутаций и посмотрите, какой тест его поймает; затем найдите в spec место, где посаженная неисправность названа.

+
tri x7-mutate · plant a bug, the tests must catch itВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/tools/trios/tri/x7-mutate.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
23

Урок 23 из 27

Выжившие мутанты

+
+

Вы научитесьЧто выживший мутант говорит о тесте, который его пропустил.

Выживший мутант — самый конкретный баг-репорт из возможных: вот неисправность, вот тест, который должен был её поймать, вот почему не поймал. Виджет посчитал их там, где никто не смотрел: 367 PR пришли в t27 за 14 дней, и 11 из них удалили тесты или ассерты; один PR с названием под реализацию удалил все 26 тестов в своём файле — и ничего не упало. Каждое из этих 11 — мутант, который выжил, и выжил он потому, что человек его пропустил, а это ровно тот класс отказов, для которого мутационное тестирование и существует.

Попробуйте

Откройте виджет test-touch и найдите PR, удаливший все 26 тестов; затем скажите, какая проверка поймала бы его на ревью.

+
Did the agent touch its own tests? Every PR merged on t27, checkedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/tools/trios/tri/x7-mutate.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
24

Урок 24 из 27

Сила тестов

+
+

Вы научитесьКак измерить набор тестов, а не любоваться им: убитые мутанты, удалённые тесты, доля пустых проходов.

Покрытие говорит, что вы прогнали; мутации говорят, чего стоит ваше прогонянье. Сила набора — счёт убитых на выбранных вами неисправностях, поведение при удалении тестов, доля проходов, исполнивших ассерт. Виджет — эталонная сторона этого измерения: все 6 эталонных битстримов на месте и прочитаны — 84.4 мс из 5 прогонов — поэтому числу скорости или силы всегда есть на что встать: на эталон, который кто-то закрепил. Измеряйте набор — или признавайтесь, что любуетесь.

Попробуйте

Измерьте одну вещь дважды, двумя способами, в стиле виджета ссылок; затем скажите, какое число вашего набора живёт без знаменателя.

+
tri x7-part · x7-refs · x7-bench: the references the bitstream path is checked onВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/tools/trios/tri/x7-mutate.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+

Модуль 9 · Приёмка

Одна команда, все квитанции, чистый вердикт, который можно показать.

+
+
25

Урок 25 из 27

Сборка и проверка

+
+

Вы научитесьКак одна команда пересобирает вердикт заново.

Сборка — не вердикт, пока её нельзя пересобрать одной командой и получить вердикт заново. Виджет — такая команда для стека битстримов: CRC 12/12 по эталонам, ECC 32520/32520 кадров, 82/82 пина, 4224/4224 сегбита, золото 5/5 — каждый прогон исполнен, у каждого счёта есть знаменатель, а последняя строка говорит: audit: CLEAN. Spec урока, build_verify, — тот же список, но как spec. Если проверки должен помнить человек, однажды их не прогонят.

Попробуйте

Запустите аудит и найдите счёт с самым большим знаменателем; затем прочитайте build_verify и отметьте, какие проверки пересчитываются, а не вспоминаются.

+
tri x7-audit · the whole bitstream path, re-checkedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/verification/build_verify.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
26

Урок 26 из 27

Стенд проверяет себя

+
+

Вы научитесьКак стенд проверяет себя перед проверкой вашего дизайна.

Стенд проверяет себя раньше вашего дизайна: 16 скриптов, названных по spec, исполняют собственные --self-test, 0 плохих, а 8 скриптов без такого флага перечислены, а не молча пропущены — в этом разница между «всё хорошо» и «всё, что мы измерили». Виджет — этот прогон. Spec урока — fpga-selftest, инвентарь того, чем бывает самопроверка. Стенд, который не может сказать, какие его инструменты не проверены, — стенд, чьи вердикты несут неизвестные погрешности.

Попробуйте

Откройте прогон самопроверок и найдите 8 скриптов без флага; затем скажите, что даёт их перечисление вместо пропуска.

+
tri fpga-selftest: off-board self-tests, no port openedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/tools/trios/tri/fpga-selftest.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+
27

Урок 27 из 27

Капстоун: проверить модуль целиком

+
+

Вы научитесьПровести один модуль от spec до платы со всем проверочным стеком за спиной.

Один модуль, весь стек. Проведите дизайн через плеер (spec чист), тестбенч (проверки исполнены, а не пропущены), векторы (ответы рядом со входами), косимуляцию (spec, симулятор и плата сходятся на стенде Artix-7 XC7A200T), покрытие (строки, переключения, дуги, запретные дуги холодны), формальные методы (ассерты проверены ограниченно, индукция попытана честно), мутации (счёт убитых на посаженных неисправностях) и приёмку (одна команда, все квитанции). Виджет — этот поток по-настоящему: размещение, трассировка, загруженный битстрим, такт на экране. Ничто в этом курсе — не шаг, который вы перерастёте.

Попробуйте

Выберите собственный модуль и запишите его план проверки: векторы, проверки тестбенча, цели покрытия, ассерты, мутанты, приёмка; затем прогоните виджет потока от начала до конца и отметьте, где ваш план остановил бы настоящий баг.

+
Place and route to a loaded bitstream, timedВиджет загрузится, когда вы до него докрутите.
Открыть виджет на отдельной странице ↗Открыть spec урока в плеере: specs/fpga/testbench/integration_tb.t27 ↗
+
Открыть интерактивный урок →
+
+
+
+ +
+
+ +
Содержание
  1. 01 · Зачем проверять
    1. 01 Баги, которые компилируются
    2. 02 Золотая модель
    3. 03 Сначала план
  2. 02 · Тестбенчи
    1. 04 Анатомия тестбенча
    2. 05 Самопроверка вместо всматривания
    3. 06 Направленные против случайных
  3. 03 · Временные диаграммы
    1. 07 Формат VCD
    2. 08 Отладка по волнам
    3. 09 Сравнение двух трасс
  4. 04 · Векторы соответствия
    1. 10 Что такое вектор
    2. 11 Векторы как эталонная линейка
    3. 12 Сквозные сценарии
  5. 05 · Косимуляция
    1. 13 Тройное согласие
    2. 14 Внутри симулятора
    3. 15 Когда они не сходятся
  6. 06 · Покрытие
    1. 16 Строки и переключения
    2. 17 Покрытие автоматов
    3. 18 Покрытие лжёт
  7. 07 · Формальные методы
    1. 19 Ассерты
    2. 20 Ограниченная проверка моделей
    3. 21 Индукция
  8. 08 · Мутации
    1. 22 Убить мутанта
    2. 23 Выжившие мутанты
    3. 24 Сила тестов
  9. 09 · Приёмка
    1. 25 Сборка и проверка
    2. 26 Стенд проверяет себя
    3. 27 Капстоун: проверить модуль целиком
+ + + + + diff --git a/apps/website/public/ru/learn/verify-hardware/index.html b/apps/website/public/ru/learn/verify-hardware/index.html index 0fce245718..8c495dce0b 100644 --- a/apps/website/public/ru/learn/verify-hardware/index.html +++ b/apps/website/public/ru/learn/verify-hardware/index.html @@ -52,19 +52,53 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish

Курс

Проверка железа с t27: тестбенчи, временные диаграммы, формальные методы, мутации

Для читателя, у которого есть дизайн и который хочет ему доверять. Каждый урок открывает настоящий инструмент проверки, собранный из реальных прогонов на нашем стенде: немного почитать, потом сломать что-нибудь нарочно.

27 уроков, в каждом работающий виджет и один spec t27: самопроверяющиеся тестбенчи, временные диаграммы, векторы, косимуляция с платой, покрытие, ассерты, мутационное тестирование и приёмка, которую можно показать.

-

Открыть интерактивный курс →

+

Открыть интерактивный курс → Весь курс на одной странице →

+

Все курсы бесплатные, для всех: без регистрации, без почты, ничего платить не нужно.

Все уроки

+
diff --git a/apps/website/public/ru/learn/what-a-spec-is/index.html b/apps/website/public/ru/learn/what-a-spec-is/index.html index 35dcd06f05..d9cedd09bb 100644 --- a/apps/website/public/ru/learn/what-a-spec-is/index.html +++ b/apps/website/public/ru/learn/what-a-spec-is/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Что такое спека

Вы узнаете

Что входит в файл .t27 и что компилятор возвращает в ответ.

Спека — это обычный текстовый файл с окончанием .t27. Он начинается строкой module, объявляет значения и функции и несёт блоки test, которые их проверяют. Компилятор t27c читает файл и отвечает вердиктом и кодом для 7 бэкендов. В спеке этого урока 2 константы и 1 тест, и сайт компилирует её прямо в вашем браузере.

Попробуйте

Откройте спеку урока в плеере и найдите три её части: строку module, константы и тест.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 1: the three parts of a spec
t27 basics 1: the three parts of a spec ↗

A table of the parts of a .t27 file and a diagram of what t27c gives back for it. Lesson 1 of the t27 basics course.

specs/basics/01_what_a_spec_is.t27

// SPDX-License-Identifier: Apache-2.0
@@ -81,6 +113,7 @@ 

Что такое спека

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/what-a-vector-is/index.html b/apps/website/public/ru/learn/what-a-vector-is/index.html index e7810f7160..35c6982e29 100644 --- a/apps/website/public/ru/learn/what-a-vector-is/index.html +++ b/apps/website/public/ru/learn/what-a-vector-is/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Что такое вектор

Вы научитесь

Что такое тест-вектор и почему ответ должен лежать рядом со входом, в файле.

Вектор — это вход с корректным выходом, записанным рядом, в файле, который инструмент может прочесть. Именно на последнем условии векторы обычно и умирают: в корпусе живут 34 векторных файла с 512 случаями, и прогон за виджетом посчитал: 2 файла реально исполнены, 8 записаны как долг, 24 — только проза, описания случаев, которые ни один раннер не разберёт. 19% несут данные. Вектор, который ничто не исполняет, — документация в одежде тестбенча.

Попробуйте

Посчитайте в переписи виджета векторные файлы, которые ни один раннер не исполняет; затем запишите один вектор, с ответом, в файл, который инструмент сможет разобрать.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri vectors debt: tests that are prose
tri vectors debt: tests that are prose ↗

34 vector files, 512 cases: 2 files executed, 8 debt, 24 prose-only; 19% carry data.

specs/numeric/formats_catalog.t27

// SPDX-License-Identifier: Apache-2.0
@@ -563,6 +595,7 @@ 

Что такое вектор

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/what-arithmetic-costs/index.html b/apps/website/public/ru/learn/what-arithmetic-costs/index.html index b574b02d73..a6c3af1d6e 100644 --- a/apps/website/public/ru/learn/what-arithmetic-costs/index.html +++ b/apps/website/public/ru/learn/what-arithmetic-costs/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Сколько стоит арифметика

Вы узнаете

Почему умножитель дорогой, а сумматор дешёвый, — по измерениям на настоящем чипе.

В логике у каждой операции есть цена, которую платят ресурсами чипа. Сумматор — это цепочка переноса, дешёвая и быстрая. Умножитель из LUT огромен; на чипе есть DSP-блоки, сделанные для умножения, и синтезатор использует их, когда ему можно. Эти кривые — настоящие подсчёты yosys от 4 до 64 битов. Выключите и включите DSP и увидите, почему в железе так заботятся о ширине каждого числа.

Попробуйте

Выберите Multiply, переключите DSP48E1 на -nodsp и сравните LUT на 32 битах с DSP и без них.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Cost curves: adders, multipliers and MACs on a Xilinx 7-series
Cost curves: adders, multipliers and MACs on a Xilinx 7-series ↗

Real yosys synth_xilinx counts for add, multiply, MAC and compare from 4 to 64 bits, with and without DSPs, against a whole XC7A200T, and t27 ternary specs beside them.

specs/tutorial/05_widths_and_casts.t27

// SPDX-License-Identifier: Apache-2.0
@@ -183,6 +215,7 @@ 

Сколько стоит арифметика

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/when-they-disagree/index.html b/apps/website/public/ru/learn/when-they-disagree/index.html index 2a48eeb147..f22cea5d3c 100644 --- a/apps/website/public/ru/learn/when-they-disagree/index.html +++ b/apps/website/public/ru/learn/when-they-disagree/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Когда они не сходятся

Вы научитесь

Как разбирать расхождение: кто из трёх врёт и как это узнать.

Когда spec, симулятор и плата расходятся, один из них врёт, и само расхождение подсказывает, где искать. Если симулятор сходится со spec, а плата отличается, подозревайте ограничения, тайминг или допущения модели — начинайте с назначений пинов: они лгут чаще всего. Виджет — инструмент триажа ровно для этого класса: перед правкой Verilog-файла он перечисляет каждый spec и генератор, которых правка коснётся, чтобы фикс не уполз молча. Сначала широта (что меняется?), потом глубина (почему именно это?).

Попробуйте

Составьте список триажа: для каждого направления расхождения (spec против симулятора, симулятор против платы) назовите файл, который вы откроете раньше прочих, и почему.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-pins · the blast radius of an edit, before the edit
tri fpga-pins · the blast radius of an edit, before the edit ↗

Before editing trinet_node_core.v: 5 specs pin it by sha256 and 5 generators read those specs. radius: 5 specs, 1 level, the exact set fpga-repin walks after the edit.

specs/tools/trios/tri/fpga-batch-cosim.t27

// SPDX-License-Identifier: Apache-2.0
@@ -105,6 +137,7 @@ 

Когда они не сходятся

Открыть spec урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/where-next/index.html b/apps/website/public/ru/learn/where-next/index.html index 6065acc61e..5a8e736dca 100644 --- a/apps/website/public/ru/learn/where-next/index.html +++ b/apps/website/public/ru/learn/where-next/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Куда дальше

Вы узнаете

Какой курс пройти дальше и что каждый добавляет к основам.

Теперь вы умеете читать спеку: строку module, константы, типы, функции, тесты и код, который пишут её бэкенды. Курс 1 ведёт спеку на FPGA Artix-7: синтез, размещение, тайминги и битстрим, проверенный на плате. Курс 2 строит на t27 форматы чисел для ИИ, от блоков OCP MX до тернарной сети. В обоих курсах по 27 уроков, и каждый урок открывает спеку.

Попробуйте

Выберите следующий курс по таблице и откройте его урок 1.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 27: three courses, in order
t27 basics 27: three courses, in order ↗

The three t27 courses in order, what each one covers and where it starts. Lesson 27 of the t27 basics course.

specs/basics/27_where_next.t27

// SPDX-License-Identifier: Apache-2.0
@@ -82,6 +114,7 @@ 

Куда дальше

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/where-the-clock-enters/index.html b/apps/website/public/ru/learn/where-the-clock-enters/index.html index 23253a3d23..a49d79b555 100644 --- a/apps/website/public/ru/learn/where-the-clock-enters/index.html +++ b/apps/website/public/ru/learn/where-the-clock-enters/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Где входит тактовый сигнал

Вы узнаете

Откуда на самом деле берётся тактовый сигнал платы и как кольцевой генератор внутри кристалла измерили на трёх кристаллах через JTAG.

Тактовый сигнал входит в плату, а не в кристалл: генератор на печатной плате ведёт вывод. Спека платы QMTech Wukong (XC7A200T в корпусе FGG676, деталь xc7a200tfgg676) ещё и измеряет тактовый сигнал, который не покидает кристалл: CFGMCLK — кольцевой генератор без кварца. UG470 даёт номинал 65 МГц в коридоре 50-80 МГц. Его измерили на трёх подключённых кристаллах, хронометрируя прескалер 2^24 через JTAG: 70770, 68490 и 67200 кГц. Запись запускает нативный t27c на спеке платы: проходят 15 тестов, 11 инвариантов доказаны comptime.

Попробуйте

В записи найдите три измеренных значения CFGMCLK и номера busdev их кристаллов; затем в окне спеки найдите коридор UG470, с которым их сравнивают, и прескалер, который сделал их читаемыми.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on wukong_v1.t27 -- the board spec, native
t27c on wukong_v1.t27 -- the board spec, native ↗

t27c 0.4.0 on a laptop (macOS): 15 tests of the Wukong board spec pass natively and 11 invariants are proved comptime; the part line names the xc7a200tfgg676 the board carries.

specs/boards/wukong_v1.t27

// SPDX-License-Identifier: Apache-2.0
@@ -365,6 +397,7 @@ 

Где входит тактовый сигнал

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/where-the-luts-go/index.html b/apps/website/public/ru/learn/where-the-luts-go/index.html index f760c66154..4b8607ad89 100644 --- a/apps/website/public/ru/learn/where-the-luts-go/index.html +++ b/apps/website/public/ru/learn/where-the-luts-go/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Куда уходят LUT

Вы узнаете

Какая часть дизайна тратит LUT и почему важна иерархия.

Дизайн собран из модулей, внутри которых модули. Когда yosys сохраняет иерархию, он считает каждый подмодуль один раз, а число экземпляров говорит, сколько копий. Treemap перемножает их и показывает, какой подмодуль съедает LUT. Один сумматор, использованный много раз, может стоить больше всего остального вместе.

Попробуйте

Переключайтесь между иерархическим и плоским итогом и найдите самый большой прямоугольник. В спеке найдите fpga_util и тест, который переводит 31700 занятых LUT в долю одного чипа: сколько процентов получается?

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

LUT treemap: which submodule eats your LUTs, from yosys stat -json
LUT treemap: which submodule eats your LUTs, from yosys stat -json ↗

Drop yosys stat -json from a run without -flatten: a treemap of LUTs or FFs per submodule, each times its instance count, beside the flattened total. Read in your browser.

specs/fpga/partition.t27

// SPDX-License-Identifier: Apache-2.0
@@ -328,6 +360,7 @@ 

Куда уходят LUT

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/which-chip/index.html b/apps/website/public/ru/learn/which-chip/index.html index 051b8e0b8b..c5fe039e39 100644 --- a/apps/website/public/ru/learn/which-chip/index.html +++ b/apps/website/public/ru/learn/which-chip/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Какой это чип?

Вы узнаете

Как чип называет себя в 32 битах и как эти биты читать.

Прежде чем что-то загружать, спросите плату, какой на ней чип. По JTAG каждый чип отвечает 32-битным IDCODE: версия, номер детали, производитель и постоянная 1 в бите 0. Битстрим, собранный для другой детали, чип отвергнет, так что эта проверка экономит вам полдня. Декодер делит биты на эти четыре поля и ищет деталь в таблице самого openFPGALoader.

Попробуйте

Нажмите пресет стенда, затем переверните один бит номера детали и посмотрите, какое это было бы устройство. В спеке действие idcode-cfg называет IDCODE, который возвращает исправный XC7A100T: раскодируйте его и сравните номер детали с чипом стенда.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

JTAG IDCODE decoder: 32 bits, four fields, one device
JTAG IDCODE decoder: 32 bits, four fields, one device ↗

Paste a 32-bit JTAG IDCODE: version, part number, JEDEC manufacturer and the fixed 1 in bit 0 as clickable bits, then the device from openFPGALoader's own table.

specs/tools/tri/fpga.t27

// SPDX-License-Identifier: Apache-2.0
@@ -111,6 +143,7 @@ 

Какой это чип?

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/who-holds-the-io/index.html b/apps/website/public/ru/learn/who-holds-the-io/index.html index c0b7f75eae..4206f968b7 100644 --- a/apps/website/public/ru/learn/who-holds-the-io/index.html +++ b/apps/website/public/ru/learn/who-holds-the-io/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Кто держит IO

Вы узнаете

Кто сейчас держит IO стенда и что заявляют зарегистрированные клиенты.

Железо, которым делятся, — это железо, которое занимают на время: стенд регистрирует своих клиентов IO, и запись читает их вживую — имена, захваты и то, что каждый заявляет своим. Спека — карточка инструмента tri fpga-ioclients. Урок замыкает круг, открытый курсом: шина, её спека, её стенд — и теперь руки на нём.

Попробовать

В записи перечислите клиентов, которых отчитывает стенд; затем в спеке найдите, что клиент должен заявить для регистрации.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

tri fpga-ioclients -- who holds the bench IO
tri fpga-ioclients -- who holds the bench IO ↗

The registered IO clients on the bench, read live: names, claims and what each client declares it owns.

specs/tools/trios/tri/fpga-ioclients.t27

// SPDX-License-Identifier: Apache-2.0
@@ -107,6 +139,7 @@ 

Кто держит IO

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/who-is-called/index.html b/apps/website/public/ru/learn/who-is-called/index.html index 056dfe47a0..a82619aadb 100644 --- a/apps/website/public/ru/learn/who-is-called/index.html +++ b/apps/website/public/ru/learn/who-is-called/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Кого зовут

Вы узнаете

Какие сообщения в группе улья будят агента — от человека и от бота другого агента.

У каждого агента свой бот и своя тема в одной форумной группе. Человек зовёт агента его тегом, через @all, ответом на сообщение или просто сообщением в его теме. Бот другого агента зовёт его только тегом или ответом: бот никогда не поднимает весь улей и не будит хозяина темы, просто написав в ней. addressed в agent-hive-group.t27 — это правило длиной в одну строку.

Попробовать

Найдите два способа, которыми агента может позвать только человек; затем включите все четыре и сравните отправителей.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Who is called: an agent bot in a group of agents
Who is called: an agent bot in a group of agents ↗

Each agent has its own bot and topic in one group. Toggle how a message reaches an agent: addressed answers for a person and for another agent's bot.

specs/automation/agent-hive-group.t27

// SPDX-License-Identifier: Apache-2.0
@@ -429,6 +461,7 @@ 

Кого зовут

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/whole-numbers/index.html b/apps/website/public/ru/learn/whole-numbers/index.html index 71e433ad76..5de1242c49 100644 --- a/apps/website/public/ru/learn/whole-numbers/index.html +++ b/apps/website/public/ru/learn/whole-numbers/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Целые числа и их ширина

Вы узнаете

Целые типы, их диапазоны и ошибка для значения, которое не помещается в тип.

Буква u в имени типа означает беззнаковый, i — со знаком, а цифры — число битов. u8 хранит от 0 до 255, u16 — от 0 до 65535, i32 хранит и отрицательные числа. Компилятор сверяет константу с её типом: дайте u8 значение 300, и он остановится с ошибкой о том, что никакой u8 не вмещает 3 цифры. В других местах проверка в браузере снисходительна, так что её молчание — не доказательство.

Попробуйте

Поставьте BYTE_MAX равным 300 в плеере и прочитайте ошибку, которую напечатает компилятор.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27 basics 5: integer widths and their ranges
t27 basics 5: integer widths and their ranges ↗

u8, u16, u32 and i32 with their bit counts and ranges, and the error t27c gives a value too big for its type. Lesson 5 of the t27 basics course.

specs/basics/05_whole_numbers.t27

// SPDX-License-Identifier: Apache-2.0
@@ -83,6 +115,7 @@ 

Целые числа и их ширина

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/why-base-three/index.html b/apps/website/public/ru/learn/why-base-three/index.html index 32f88b20fd..23a2a0a444 100644 --- a/apps/website/public/ru/learn/why-base-three/index.html +++ b/apps/website/public/ru/learn/why-base-three/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Почему основание три

Вы узнаете

Почему ln(b) / b достигает пика в e, насколько близко подходит основание 3 и сколько битов стоят 27 тритов.

Экономия основания оценивает основание b числом E(b) = ln(b) / b, и анализ ставит пик в b = e, где E = 1 / e = 0.36788. radix_economy.t27 вписывает соседей: E(2) = 0.34657 и E(3) = 0.36620. Основание 3 достигает 0.995 от пика, а E(3) / E(2) = 1.0566, преимущество 5.66 процента; спека ограничивает его снизу числом 0.054, то есть 5.4 процента, хотя инвариант назван 54_percent. По диапазону 27 сбалансированных тритов доходят до 3812798742493, выше 2^41 - 1 и ниже 2^42 - 1, так что им нужно 42 бита. Это доводы о цифрах, а не замер времени на троичной машине.

Попробуйте

Разделите E_BASE3 на E_BASE2 из radix_economy.t27 вручную. Затем найдите инвариант с именем 54_percent и скажите, какое число он на самом деле проверяет.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 5: why base three
GoldenFloat 5: why base three ↗

Radix economy ln(b) / b for bases 2, 3 and e, and 27 trits in bits, read from radix_economy.t27. Lesson 5 of the GoldenFloat course.

specs/math/radix_economy.t27

// SPDX-License-Identifier: Apache-2.0
@@ -412,6 +444,7 @@ 

Почему основание три

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/why-binary-fails/index.html b/apps/website/public/ru/learn/why-binary-fails/index.html index 3943287d0a..83ba250779 100644 --- a/apps/website/public/ru/learn/why-binary-fails/index.html +++ b/apps/website/public/ru/learn/why-binary-fails/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Почему двоичный код рвётся

Вы узнаете

Почему сэмплирование двоичной шины в другом домене рвёт её и что спека FIFO проверяет у указателей.

Пересеките многобитную шину сэмплированием в другом домене — и она порвётся: часть бит придёт от старого значения, часть от нового, и прочитанного значения никогда не существовало. Двоичный счётчик — худший носитель: с 7 на 8 переворачиваются сразу четыре бита. fifo.t27 — буфер, который делает это правильно, его голова движется как (head_ptr + 1) % depth, а MAX_FIFO_DEPTH равен 65536. Запись запускает нативный t27c на нём: проходят 18 тестов, 6 инвариантов comptime. Тесты проверяют счётчики заполнения и флаги; следующий урок показывает, чего они не проверяют никогда.

Попробуйте

В записи посчитайте прошедшие тесты и доказанные инварианты; затем в окне спеки найдите обновление указателя головы и константу максимальной глубины.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on fifo.t27 -- the FIFO stdlib, native
t27c on fifo.t27 -- the FIFO stdlib, native ↗

t27c 0.4.0 on a laptop (macOS): 18 tests of the FIFO spec pass natively, 6 invariants comptime -- push and pop state, flags, BRAM count.

specs/fpga/fifo.t27

// SPDX-License-Identifier: Apache-2.0
@@ -432,6 +464,7 @@ 

Почему двоичный код рвётся

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/why-bridges/index.html b/apps/website/public/ru/learn/why-bridges/index.html index f193a0bfee..cbe7f55180 100644 --- a/apps/website/public/ru/learn/why-bridges/index.html +++ b/apps/website/public/ru/learn/why-bridges/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Зачем мосты

Вы узнаете

Почему в дизайне появляется больше одной шины и что спека моста проверяет о собственном состоянии.

Дизайн выращивает больше одной шины, потому что периферия и вычисления различаются: медленная шина регистров для ручек, широкая — для данных. Спека моста, FPGA_Bridge, — это переход этого дизайна, и bridge_initially_idle и bridge_rx_buffers_empty — два из её двадцати одного теста. Запись прогоняет t27c check: 0 ошибок, 0 предупреждений.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите два теста покоя и посчитайте тесты спеки.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c check on bridge.t27 -- the spec compiles
t27c check on bridge.t27 -- the spec compiles ↗

t27c check typechecks the bus bridge spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/bridge.t27

// SPDX-License-Identifier: Apache-2.0
@@ -591,6 +623,7 @@ 

Зачем мосты

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/why-the-split-is-phi/index.html b/apps/website/public/ru/learn/why-the-split-is-phi/index.html index 9199aabf00..d6a7e8f8fa 100644 --- a/apps/website/public/ru/learn/why-the-split-is-phi/index.html +++ b/apps/website/public/ru/learn/why-the-split-is-phi/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Почему деление по phi

Вы узнаете

Два довода за деление по phi и почему спека говорит, что довод о самоподобии — не оптимизация.

phi_split_optimality.t27 приводит два довода и говорит, какой из них какой. Один довод — самоподобие: потребуем, чтобы порядок относился к мантиссе, как мантисса к обоим полям вместе, E / M = M / (E + M). С r = E / M это r = 1 / (r + 1), значит r^2 + r - 1 = 0 и r = (sqrt(5) - 1) / 2 = 1 / phi. Спека прямо говорит, что это определяющее свойство, а не оптимизация: если просто максимизировать E * M, деление выходит поровну, 7 и 7 для 14 битов. Другой довод — про округление: round((N - 1) / phi^2) — ближайшее к идеалу целое, и verify_7_7_match находит его равным опубликованному делению в 7 из 7 форматов.

Попробуйте

Прочитайте self_similarity_proof_steps и сосчитайте шаги. Затем найдите тест, который говорит, что деление по AM-GM отличается от деления по phi, и ширину, которую он берёт.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

GoldenFloat 4: why the split is phi
GoldenFloat 4: why the split is phi ↗

Two arguments for the phi split, and one that gives an equal split instead, read from phi_split_optimality.t27. Lesson 4 of the GoldenFloat course.

specs/math/phi_split_optimality.t27

// SPDX-License-Identifier: Apache-2.0
@@ -426,6 +458,7 @@ 

Почему деление по phi

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/why-three/index.html b/apps/website/public/ru/learn/why-three/index.html index afa8a55dda..61d64c48d9 100644 --- a/apps/website/public/ru/learn/why-three/index.html +++ b/apps/website/public/ru/learn/why-three/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Почему три

Вы узнаете

Почему основание 3 — самое дешёвое целое основание для записи чисел и что этот довод упускает.

Число в системе с основанием b занимает сколько-то цифр, и каждая цифра должна различать b состояний. Если цена цифры равна b, число стоит b, умноженное на число цифр. Виджет запускает собственную cost() спеки: любое число до 999999 стоит 39 в основании 3 и 40 в основаниях 2 и 4. На длинном отрезке цена одной цифры равна b / ln b, и минимум у неё в точке e; 3 — ближайшее к ней целое. Модель не объясняет, почему победила двоичная система: элементы на два состояния дёшевы, быстры и надёжны.

Попробовать

Переберите все диапазоны и отметьте самое дешёвое основание; найдите диапазон, где выигрывает основание 2, и объясните, почему кривая всё равно за 3.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

Why three: what a number costs in each base
Why three: what a number costs in each base ↗

Pick a range of numbers. Every base pays digits times states per digit; base 3 pays least, bases 2 and 4 tie behind it.

specs/ternary/radix_economy.t27

// SPDX-License-Identifier: Apache-2.0
@@ -182,6 +214,7 @@ 

Почему три

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/wires-that-talk/index.html b/apps/website/public/ru/learn/wires-that-talk/index.html index 311e3a721a..9b4bbba9eb 100644 --- a/apps/website/public/ru/learn/wires-that-talk/index.html +++ b/apps/website/public/ru/learn/wires-that-talk/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

Провода, которые говорят

Вы узнаете

Зачем нужна шина, сколько стоит двухпроводный разговор UART и что проверяет спека, открывающая курс.

Шина существует потому, что выводы дороги: двум чипам, которым надо поговорить, приходится делить провода, и провода несут разговор, о котором обе стороны договорились заранее. Простейший случай — UART из спеки этого урока, ZeroDSP_UART: два провода, без такта, обе стороны согласовали скорость — спека несёт UART_CLOCK_HZ равный 100,000,000 и UART_BAUD_RATE равный 115,200. Запись прогоняет t27c check по спеке: 0 ошибок, 0 предупреждений — стартовую планку, которую проходит спека каждого урока. Плеер компилирует её в вашем браузере.

Попробовать

В записи найдите количество ошибок и предупреждений; затем в спеке найдите UART_CLOCK_HZ и UART_BAUD_RATE и разделите их, получив период бита.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c check on uart.t27 -- the spec compiles
t27c check on uart.t27 -- the spec compiles ↗

t27c check typechecks the UART spec: 0 errors, 0 warnings, the first bar every lesson's spec clears.

specs/fpga/uart.t27

// SPDX-License-Identifier: Apache-2.0
@@ -297,6 +329,7 @@ 

Провода, которые говорят

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/ru/learn/xor-needs-a-bend/index.html b/apps/website/public/ru/learn/xor-needs-a-bend/index.html index d21c5be3a6..e12ab25765 100644 --- a/apps/website/public/ru/learn/xor-needs-a-bend/index.html +++ b/apps/website/public/ru/learn/xor-needs-a-bend/index.html @@ -51,10 +51,42 @@ pre { overflow-x: auto; background: #0b0f0e; border: 1px solid #1e2624; border-radius: 10px; padding: 14px 16px; font: 13px/1.5 'JetBrains Mono', ui-monospace, monospace; color: #cfe3de; max-height: 520px; } .about { color: #b9c4c2; font-size: 16px; } .outline li.on a { color: #fff; font-weight: 600; } footer { color: #8fa19d; font-size: 15px; } +.cta { min-height: 44px; margin-right: 8px; } .free { display: inline-block; padding: 6px 14px; border: 1px solid #fff; border-radius: 999px; color: #fff; font-size: 15px; } +.course-page, +.op-page { + --course-read: 30.1em; + --course-text-px: 18px; + --course-page-max: 1440px; + --course-toc-width: 240px; + --course-widget-min: 400px; + --course-col-gap: 32px; + --course-gutter-wide: 20px; + --course-gutter-phone: 16px; + --course-frame-min: 320px; + --course-touch: 44px; + --course-thumb-bar: 56px; + --course-focus-ring: 2px; +} +.course-page:lang(ru), +.op-page:lang(ru) { + --course-read: 37.2em; +} +.claw { margin: 48px 0 24px; padding: 24px 0 0; border-top: 6px solid #fff; } +.claw-kicker { margin: 0 0 6px; font-size: 12px; letter-spacing: .24em; text-transform: uppercase; color: #a6a6a6; } +.claw-title { margin: 0 0 8px; font-size: clamp(24px, 4vw, 34px); line-height: 1.1; color: #fff; letter-spacing: -.02em; text-transform: none; } +.claw-line { margin: 0 0 20px; color: #c8c8c8; max-width: var(--course-read); } +.claw-paths { list-style: none; margin: 0; padding: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr)); } +.claw-path { display: flex; flex-direction: column; gap: 8px; padding: 16px; border: 1px solid #333; border-radius: 12px; background: #050505; } +.claw-path.is-primary { border-color: #fff; } +.claw-path-title { margin: 0; font-size: 18px; color: #fff; letter-spacing: 0; text-transform: none; } +.claw-path-line { margin: 0; flex: 1; font-size: 15px; line-height: 1.5; color: #b3b3b3; } +.claw-press { display: inline-flex; align-items: center; justify-content: center; min-height: var(--course-touch); padding: 0 16px; border: 1px solid #fff; border-radius: 999px; color: #fff; text-decoration: none; font-weight: 600; } +.claw-path.is-primary .claw-press { background: #fff; color: #000; } +.claw-press:hover { background: #d9d9d9; color: #000; } @media (prefers-reduced-motion: reduce) { * { transition: none !important; } } - +
t27.aiEnglish
@@ -62,7 +94,7 @@

XOR нужен излом

Вы узнаете

Почему сети нужен скрытый слой с ReLU, чтобы вычислить XOR, и что делает один пропавший излом.

XOR равен 1, когда ровно один вход равен 1, и комментарий в gft_xornet.t27 говорит, что одиночная линейная модель не может его разделить. on_comb — 2-слойная сеть: две скрытые суммы, z0 и z1, каждая через relu, затем взвешенная сумма h0 и h1. Она не обучается: тесты подают веса, заданные вручную, аналитическое решение W=[[1,1],[1,1]], c=[0,-1], v=[1,-2]. Браузер пропускает все 4 теста, потому что его исполнитель пока не знает assert_eq; нативный t27c запускает все 4, все проходят, ни один не пустой. Запись запускает t27c test-report, затем однострочный sed, который убирает relu только у h1, и снова t27c test-report: падает ровно один тест, x00: в (0,0) z1 равно -1.0, и выход становится 2.0 вместо 0. git checkout возвращает строку на место, и sha256sum печатает тот же хеш, что и до правки. Каждый байт в записи напечатала команда; инсценирован только набор текста.

Попробуйте

Найдите в записи изменённую строку и упавший тест; затем вычислите в спеке z1 для x10, x01 и x11 и поймите, почему relu там ничего не меняет.

-

Открыть интерактивный урок →

+

Открыть интерактивный урок → Весь курс на одной странице →

t27c on gft_xornet.t27 -- XOR needs a bend, native
t27c on gft_xornet.t27 -- XOR needs a bend, native ↗

t27c 0.5.1 and zig 0.16.0 in a Claude Code cloud container (Linux x86_64), spec at t27 72f793357: all 4 tests pass natively, none vacuous; removing relu from h1 makes exactly one test fail, x00; git restores the spec.

specs/ternary/gft_xornet.t27

module GftXorNet;
@@ -213,6 +245,7 @@ 

XOR нужен излом

Открыть спеку урока в плеере ↗

Все уроки

+
diff --git a/apps/website/public/widgets/course-deck/course-deck.t27 b/apps/website/public/widgets/course-deck/course-deck.t27 new file mode 100644 index 0000000000..2bb2fa02e8 --- /dev/null +++ b/apps/website/public/widgets/course-deck/course-deck.t27 @@ -0,0 +1,68 @@ +// SPDX-License-Identifier: Apache-2.0 +; specs/widgets/course-deck.t27 -- a whole t27.ai course as one embeddable widget: its nine modules +; as tabs, each module's three lessons as a row of cards, each card holding that lesson's own widget. +; Source of truth for public/widgets/course-deck/ (gHashTag/trinity): scripts/widget-pages-from-spec.mjs +; compiles this file, checks its constants, evaluates the tests below and writes the page. tool.js draws +; the deck from courses/.json beside it (written by scripts/course-pages.mjs from the course +; specs, src/lib/course.generated.ts) and nests each lesson's widget page as an iframe through +; ../frame-pool.js, which mounts a frame only near the viewport and keeps at most K_LIVE_FRAMES_MAX live. +; ONE WIDGET FOR EVERY COURSE: the course is a parameter (?course=, the first course when absent, +; &module=, &lang=ru), not a copy per course. Eleven copies would differ only in their data, and a +; twelfth course would need a twelfth widget; here it needs nothing. +; THE NUMBERS ARE NOT THE DECK'S: every K_ below that specs/view/course-view.t27 also names is +; that spec's number, held equal by scripts/course-view-from-spec.mjs. No K_ holds a spec function's +; result. ASCII only (L3), English only (LANG-EN). +; phi^2 + 1/phi^2 = 3 | TRINITY + +module widget_course_deck; + +pub const KIND : str = "widget-tool"; +pub const ID : str = "course-deck"; +pub const TITLE : str = "Course deck: a t27 course, module by module, widget by widget"; +pub const DESCRIPTION : str = "Any free t27.ai course in one embed: nine module tabs, three lesson cards each, every card running that lesson's own widget, loaded only as you reach it."; +pub const IMAGE_ALT : str = "A black and white card: the line A whole course in one embed, 9 modules, 27 live lesson widgets; nine module tabs with the first one lit; and the three lesson cards of the first module of t27 basics (What a spec is, The module line, Comments and prose lines), each over a widget frame."; +pub const HOOK : str = "One iframe, one whole course: 9 modules, 27 lesson widgets, each loaded only when you reach it."; +pub const CATEGORY : str = "game"; +pub const DATA_SOURCES : [2]str = ["The course specs specs/course/*.t27 and their Russian bundles, read by scripts/course-from-spec.mjs and written beside this page as courses/.json by scripts/course-pages.mjs", "The frame budget and the load margins of specs/view/course-view.t27, held equal to the K_ numbers here by scripts/course-view-from-spec.mjs"]; +pub const READS_LOCAL_FILES : bool = false; +pub const SENDS_NOTHING : bool = true; + +; --- The words --------------------------------------------------------------------------------- +pub const SAY_MODULES : str = "Modules"; +pub const SAY_MODULE : str = "Module {0}"; +pub const SAY_LESSON : str = "Lesson {0} of {1}"; +pub const SAY_GOAL : str = "You will learn"; +pub const SAY_OPEN_LESSON : str = "Open the lesson"; +pub const SAY_ONE_PAGE : str = "Whole course on one page"; +pub const SAY_LOAD : str = "Load the widget"; +pub const SAY_PREV : str = "Previous lesson"; +pub const SAY_NEXT : str = "Next lesson"; +pub const SAY_FREE : str = "Free course"; +pub const SAY_NOT_FOUND : str = "This course is not in the catalog."; + +; --- The numbers ------------------------------------------------------------------------------- +pub const K_MODULES : u8 = 9; +pub const K_LESSONS_PER_MODULE : u8 = 3; +pub const K_LESSONS : u8 = 27; +pub const K_LIVE_FRAMES_MAX : u8 = 3; +pub const K_MOUNT_MARGIN_PX : u16 = 600; +pub const K_UNMOUNT_MARGIN_PX : u16 = 2000; +pub const K_FRAME_MIN_PX : u16 = 320; +pub const K_FRAME_MAX_PX : u16 = 900; +pub const K_TOUCH_TARGET_PX : u8 = 44; + +test a_course_is_nine_tabs_of_three_cards { + assert K_MODULES * K_LESSONS_PER_MODULE == K_LESSONS; + assert K_LESSONS == 27; +} + +; The cards of one module are the frames a phone may keep: a whole module stays live while it is read. +test one_module_is_one_frame_budget { + assert K_LIVE_FRAMES_MAX == K_LESSONS_PER_MODULE; + assert K_UNMOUNT_MARGIN_PX > K_MOUNT_MARGIN_PX; + assert K_FRAME_MIN_PX < K_FRAME_MAX_PX; +} + +test every_tab_and_button_takes_a_finger { + assert K_TOUCH_TARGET_PX >= 44; +} diff --git a/apps/website/public/widgets/course-deck/courses/ai-numbers.json b/apps/website/public/widgets/course-deck/courses/ai-numbers.json new file mode 100644 index 0000000000..67d6367c0c --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/ai-numbers.json @@ -0,0 +1 @@ +{"id":"ai-numbers","route":"ai-numbers","title":{"en":"AI numbers with t27: from number formats to a ternary network","ru":"ИИ-числа на t27: от форматов чисел до тернарной сети"},"onePage":{"en":"/learn/ai-numbers/all/","ru":"/ru/learn/ai-numbers/all/"},"modules":[{"n":1,"title":{"en":"Lab: our own research","ru":"Лаборатория: наши исследования"},"lessons":[{"id":"t27-number-format","n":1,"title":{"en":"T27: a number format of our own","ru":"T27: наш собственный формат чисел"},"goal":{"en":"How three trits give more levels than a 4-bit float, and what that costs in plain bits.","ru":"Как три трита дают больше уровней, чем 4-битное число с плавающей точкой, и чего это стоит в обычных битах."},"frame":"widgets/t27-cell/index.html?embed=1","widget":"T27 cell: 27 seats in 3 trits against FP4's 16 codes in 4 bits","height":640},{"id":"an-honest-scoreboard","n":2,"title":{"en":"An honest scoreboard","ru":"Честная таблица результатов"},"goal":{"en":"How T27 was compared with NVFP4, MX+ and MXFP4 on a real language model, and what the result does not show.","ru":"Как T27 сравнивали с NVFP4, MX+ и MXFP4 на настоящей языковой модели и чего этот результат не показывает."},"frame":"widgets/t27-vs-nvfp4/index.html?embed=1","widget":"T27 vs NVFP4: six weight formats on one small language model","height":640},{"id":"a-model-on-the-board","n":3,"title":{"en":"A model's tables on the board","ru":"Таблицы модели на плате"},"goal":{"en":"How the host feeds the board over a serial bridge, why the window size matters, and what the board computed.","ru":"Как компьютер кормит плату работой через последовательный мост, почему важен размер окна и что плата посчитала."},"frame":"widgets/uart-bucket/index.html?embed=1","widget":"The bucket under the tap: a 512-byte UART buffer and 19-byte answers","height":640}]},{"n":2,"title":{"en":"AI numbers: the MX block","ru":"ИИ-числа: блок MX"},"lessons":[{"id":"one-scale-per-block","n":4,"title":{"en":"One scale for a block of weights","ru":"Один масштаб на блок весов"},"goal":{"en":"Why AI formats share one scale across a block of weights, and how the scale byte of OCP MX is read.","ru":"Почему ИИ-форматы делят один масштаб на блок весов и как читается байт масштаба OCP MX."},"frame":"play/embed.html?spec=specs%2Fnumeric%2Fe8m0.t27&cast=t27c-e8m0&v=7cbe9ab0c960","widget":"e8m0.t27, the OCP MX scale byte, compiled inside the post","height":480},{"id":"scale-byte-native","n":5,"title":{"en":"The scale byte on a real machine","ru":"Байт масштаба на настоящей машине"},"goal":{"en":"What the native compiler checks in the same spec, including what the browser skipped.","ru":"Что нативный компилятор проверяет в той же спеке, включая то, что браузер пропустил."},"frame":"term/t27c-e8m0/index.html","widget":"t27c on e8m0.t27 -- the MX shared scale byte, native","height":640},{"id":"one-outlier","n":6,"title":{"en":"One outlier, many zeros","ru":"Один выброс, много нулей"},"goal":{"en":"What a shared scale costs: how one large weight pushes the small weights of its block to zero, format by format.","ru":"Чего стоит общий масштаб: как один крупный вес обнуляет мелкие веса своего блока, формат за форматом."},"frame":"term/t27c-ocp-mx/index.html","widget":"t27c on ocp_mx.t27 -- OCP MX v1.0, native","height":640}]},{"n":3,"title":{"en":"Ternary weights","ru":"Тернарные веса"},"lessons":[{"id":"phi-scaled-ternary","n":7,"title":{"en":"Weights of minus phi, zero and plus phi","ru":"Веса минус фи, ноль и плюс фи"},"goal":{"en":"How a ternary weight is stored in 2 bits, what the fourth code is for, and what the spec does not claim about phi.","ru":"Как тернарный вес хранится в 2 битах, зачем нужен четвёртый код и чего спека не утверждает о фи."},"frame":"play/embed.html?spec=specs%2Fnumeric%2Fgfternary.t27&cast=t27c-gfternary&v=7cbe9ab0c960","widget":"gfternary.t27, phi-scaled ternary weights, compiled inside the post","height":480},{"id":"a-pass-that-checked-nothing","n":8,"title":{"en":"A pass that checked nothing","ru":"Прогон, который ничего не проверил"},"goal":{"en":"What a vacuous pass is, why a green report can hide one, and how a planted bug tells real checks from empty ones.","ru":"Что такое пустой проход, почему зелёный отчёт может его скрыть и как подложенная ошибка отличает настоящие проверки от пустых."},"frame":"term/t27c-gfternary/index.html","widget":"t27c on gfternary.t27 -- phi-scaled ternary weights, native","height":640},{"id":"five-rules-for-weights","n":9,"title":{"en":"Five rules for a weight alphabet","ru":"Пять правил для алфавита весов"},"goal":{"en":"What values a ternary weight may take, how five measured rules leave one formula, and what a sixth rule removes from it.","ru":"Какие значения может принимать тернарный вес, как пять измеренных правил оставляют одну формулу и что из неё убирает шестое правило."},"frame":"play/embed.html?spec=specs%2Fnumeric%2Fgolden_sieve.t27&cast=t27c-golden-sieve&v=7cbe9ab0c960","widget":"golden_sieve.t27, the ternary sieve, compiled inside the post","height":480}]},{"n":4,"title":{"en":"The Ternary Network Float","ru":"Тернарный формат Ternary Network Float"},"lessons":[{"id":"blocked-is-not-failed","n":10,"title":{"en":"Blocked is not failed","ru":"Заблокирован — не значит провален"},"goal":{"en":"Why a rule checked while compiling stops a spec before any test runs, and how that differs from a failing test.","ru":"Почему правило, проверяемое при компиляции, останавливает спеку до запуска любого теста и чем это отличается от упавшего теста."},"frame":"term/t27c-golden-sieve/index.html","widget":"t27c on golden_sieve.t27 -- the ternary sieve, native","height":640},{"id":"four-trit-exponent","n":11,"title":{"en":"A float whose exponent is four trits","ru":"Число, у которого порядок — четыре трита"},"goal":{"en":"How TNF17e packs a sign, a ternary exponent and a mantissa into 17 bits, and why 17 and not 16.","ru":"Как TNF17e упаковывает знак, тернарный порядок и мантиссу в 17 бит и почему 17, а не 16."},"frame":"play/embed.html?spec=specs%2Fnumeric%2Ftnf17.t27&cast=t27c-tnf17&v=7cbe9ab0c960","widget":"tnf17.t27, a 17-bit ternary-exponent float, compiled inside the post","height":480},{"id":"negate-twice","n":12,"title":{"en":"Negate twice, get the number back","ru":"Дважды сменить знак — получить число обратно"},"goal":{"en":"How a test of a property catches a one-character bug that a single example misses.","ru":"Как тест свойства ловит ошибку в один символ, которую пропускает единичный пример."},"frame":"term/t27c-tnf17/index.html","widget":"t27c on tnf17.t27 -- a 17-bit ternary-exponent float, native","height":640}]},{"n":5,"title":{"en":"Arithmetic on signed numbers","ru":"Арифметика чисел со знаком"},"lessons":[{"id":"a-sign-is-one-bit","n":13,"title":{"en":"A sign is one bit","ru":"Знак — это один бит"},"goal":{"en":"How a signed multiply sets the sign of its product, and which test notices when it never does.","ru":"Как умножение чисел со знаком ставит знак произведения и какой тест замечает, когда знак не ставится никогда."},"frame":"term/t27c-gft-smul/index.html","widget":"t27c on gft_smul.t27 -- a sign is one bit, native","height":640},{"id":"opposite-signs-subtract","n":14,"title":{"en":"Opposite signs subtract","ru":"Разные знаки — вычитание"},"goal":{"en":"How a signed add turns into a subtraction when the signs differ, and what its 3 tests leave unchecked.","ru":"Как сложение чисел со знаком превращается в вычитание, когда знаки разные, и что его 3 теста оставляют непроверенным."},"frame":"term/t27c-gft-sadd/index.html","widget":"t27c on gft_sadd.t27 -- opposite signs subtract, native","height":640},{"id":"multiply-then-add","n":15,"title":{"en":"Multiply, then add","ru":"Умножить, потом сложить"},"goal":{"en":"What a multiply-accumulate does with two signed products, and how the swap from lesson 12 breaks it.","ru":"Что умножение с накоплением делает с двумя произведениями со знаком и как его ломает замена из урока 12."},"frame":"term/t27c-gft-signed-mac/index.html","widget":"t27c on gft_signed_mac.t27 -- multiply, then add, native","height":640}]},{"n":6,"title":{"en":"Parts of a neuron","ru":"Части нейрона"},"lessons":[{"id":"a-bend-at-zero","n":16,"title":{"en":"A bend at zero","ru":"Излом в нуле"},"goal":{"en":"Why a ReLU needs a test with a negative input before anyone can say it bends.","ru":"Почему ReLU нужен тест с отрицательным входом, прежде чем можно сказать, что у неё есть излом."},"frame":"term/t27c-gft-relu/index.html","widget":"t27c on gft_relu.t27 -- a bend at zero, native","height":640},{"id":"two-to-the-x","n":17,"title":{"en":"Two to the x","ru":"Два в степени x"},"goal":{"en":"How exp2 splits x into a whole part and a fraction, and why its tests only reach the whole part.","ru":"Как exp2 делит x на целую часть и дробь и почему её тесты доходят только до целой части."},"frame":"term/t27c-gft-exp2/index.html","widget":"t27c on gft_exp2.t27 -- two to the x, native","height":640},{"id":"pick-the-largest","n":18,"title":{"en":"Pick the largest","ru":"Выбрать наибольшее"},"goal":{"en":"How argmax names a class by comparing bits alone, and which rule settles a tie.","ru":"Как argmax называет класс, сравнивая одни только биты, и какое правило решает ничью."},"frame":"term/t27c-gft-argmax4/index.html","widget":"t27c on gft_argmax4.t27 -- pick the largest, native","height":640}]},{"n":7,"title":{"en":"Learning from a mistake","ru":"Обучение на ошибке"},"lessons":[{"id":"a-loss-in-bits","n":19,"title":{"en":"A loss in bits","ru":"Потеря в битах"},"goal":{"en":"How the loss -log2(p) prices a guess in bits, and why a perfect guess must cost exactly 0.","ru":"Как потеря -log2(p) оценивает догадку в битах и почему безошибочная догадка должна стоить ровно 0."},"frame":"term/t27c-gft-nll/index.html","widget":"t27c on gft_nll.t27 -- a loss in bits, native","height":640},{"id":"one-step-downhill","n":20,"title":{"en":"One step downhill","ru":"Один шаг вниз по склону"},"goal":{"en":"How one SGD step moves a weight against its gradient, and why a test with two equal inputs cannot tell them apart.","ru":"Как один шаг SGD сдвигает вес против градиента и почему тест с двумя равными входами не может их различить."},"frame":"term/t27c-gft-sgd-step/index.html","widget":"t27c on gft_sgd_step.t27 -- one step downhill, native","height":640},{"id":"xor-needs-a-bend","n":21,"title":{"en":"XOR needs a bend","ru":"XOR нужен излом"},"goal":{"en":"Why a network needs a hidden ReLU layer to compute XOR, and what one missing bend does.","ru":"Почему сети нужен скрытый слой с ReLU, чтобы вычислить XOR, и что делает один пропавший излом."},"frame":"term/t27c-gft-xornet/index.html","widget":"t27c on gft_xornet.t27 -- XOR needs a bend, native","height":640}]},{"n":8,"title":{"en":"BitNet: ternary networks","ru":"BitNet: тернарные сети"},"lessons":[{"id":"back-to-three-values","n":22,"title":{"en":"Back to three values","ru":"Обратно в три значения"},"goal":{"en":"How a threshold turns a neuron's sum back into a trit, and why each edge of the dead band needs its own test.","ru":"Как порог превращает сумму нейрона обратно в трит и почему каждому краю мёртвой зоны нужен свой тест."},"frame":"term/t27c-activation-quantizer/index.html","widget":"t27c on activation_quantizer.t27 -- Quantize at the edge, native","height":640},{"id":"same-neuron-new-weights","n":23,"title":{"en":"Same neuron, new weights","ru":"Тот же нейрон, другие веса"},"goal":{"en":"How one ternary neuron computes a majority vote with one set of weights and a different function with another.","ru":"Как один тернарный нейрон считает голосование большинством с одними весами и другую функцию — с другими."},"frame":"term/t27c-bitnet-majority/index.html","widget":"t27c on bitnet_majority.t27 -- One neuron, two functions, native","height":640},{"id":"a-neuron-in-chunks","n":24,"title":{"en":"A neuron in chunks","ru":"Нейрон по кускам"},"goal":{"en":"How a neuron with more than 27 inputs adds up its dot products chunk by chunk, and why a test with zero chunks matters.","ru":"Как нейрон с числом входов больше 27 складывает скалярные произведения кусок за куском и почему важен тест без кусков."},"frame":"term/t27c-bitnet-neuron-nchunk/index.html","widget":"t27c on bitnet_neuron_nchunk.t27 -- A neuron over N chunks, native","height":640}]},{"n":9,"title":{"en":"The ternary MAC as a chip","ru":"Тернарный MAC как чип"},"lessons":[{"id":"a-dot-product-in-wires","n":25,"title":{"en":"A dot product made of wires","ru":"Скалярное произведение из проводов"},"goal":{"en":"What on_comb turns a spec into, and how one wrong sign in tmul shows up in exactly one test.","ru":"Во что on_comb превращает спеку и как один неверный знак в tmul проявляется ровно в одном тесте."},"frame":"term/t27c-comb-ternary-dot/index.html","widget":"t27c on comb_ternary_dot.t27 -- The dot product as wires, native","height":640},{"id":"add-it-up-every-clock","n":26,"title":{"en":"Add it up on every clock","ru":"Складывать на каждом такте"},"goal":{"en":"What on_clock adds to the dot product, and why this spec's tests never reach the register.","ru":"Что on_clock добавляет к скалярному произведению и почему тесты этой спеки не доходят до регистра."},"frame":"term/t27c-stream-ternary-mac/index.html","widget":"t27c on stream_ternary_mac.t27 -- Accumulate on the clock, native","height":640},{"id":"a-whole-network","n":27,"title":{"en":"A whole network","ru":"Целая сеть"},"goal":{"en":"How the pieces of this course fit into one small network, and what its tests and its Verilog still leave open.","ru":"Как части этого курса складываются в одну небольшую сеть и что её тесты и её Verilog ещё оставляют открытым."},"frame":"term/t27c-bitnet-mlp/index.html","widget":"t27c on bitnet_mlp.t27 -- A whole ternary network, native","height":640}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/arithmetic-and-dsp.json b/apps/website/public/widgets/course-deck/courses/arithmetic-and-dsp.json new file mode 100644 index 0000000000..99851f16b1 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/arithmetic-and-dsp.json @@ -0,0 +1 @@ +{"id":"arithmetic-and-dsp","route":"arithmetic-and-dsp","title":{"en":"Arithmetic and DSP on the FPGA: from the carry chain to a filter","ru":"Арифметика и DSP на FPGA: от цепи переноса до фильтра"},"onePage":{"en":"/learn/arithmetic-and-dsp/all/","ru":"/ru/learn/arithmetic-and-dsp/all/"},"modules":[{"n":1,"title":{"en":"Adding numbers","ru":"Сложение"},"lessons":[{"id":"the-carry-chain","n":1,"title":{"en":"The carry chain","ru":"Цепь переноса"},"goal":{"en":"Why a carry walks the whole word, and how the dedicated chain of a slice makes the walk cheap.","ru":"Почему перенос проходит всё слово и как выделенная цепь слайса делает этот путь дешёвым."},"frame":"widgets/carry-chain/index.html?embed=1","widget":"The carry chain: why adding is slow, and how a slice makes it fast","height":760},{"id":"prefix-adders","n":2,"title":{"en":"Looking ahead: prefix adders","ru":"Взгляд вперёд: префиксные сумматоры"},"goal":{"en":"How a prefix network computes every carry in log2 n levels, and what Kogge-Stone, Sklansky and Brent-Kung pay for it.","ru":"Как префиксная сеть вычисляет все переносы за log2 n уровней и чем за это платят Kogge-Stone, Sklansky и Brent-Kung."},"frame":"widgets/prefix-adder/index.html?embed=1","widget":"Prefix adders: trade logic levels for cells and wires","height":760},{"id":"carry-save","n":3,"title":{"en":"Three numbers at once","ru":"Три числа сразу"},"goal":{"en":"How 3:2 counters add many numbers with almost no carry propagation, and how many layers k numbers need.","ru":"Как счётчики 3:2 складывают много чисел почти без распространения переноса и сколько слоёв нужно для k чисел."},"frame":"widgets/csa-tree/index.html?embed=1","widget":"Carry-save adders: add many numbers with almost no carries","height":760}]},{"n":2,"title":{"en":"Multiplying","ru":"Умножение"},"lessons":[{"id":"shift-and-add","n":4,"title":{"en":"Shift and add","ru":"Сдвиг и сложение"},"goal":{"en":"Why a multiplier is a pile of shifted partial products, and how many of them a number costs.","ru":"Почему умножитель — это стопка сдвинутых частичных произведений и сколько их стоит число."},"frame":"widgets/shift-add/index.html?embed=1","widget":"Shift and add: a multiplier is a pile of shifted copies","height":760},{"id":"booths-trick","n":5,"title":{"en":"Booth's trick","ru":"Приём Бута"},"goal":{"en":"How radix-4 Booth recoding turns eight rows into four and handles signed numbers with no special case.","ru":"Как перекодирование Бута по основанию 4 превращает восемь строк в четыре и обрабатывает знаковые числа без особого случая."},"frame":"widgets/booth-radix4/index.html?embed=1","widget":"Booth's trick: half the partial products, signs for free","height":760},{"id":"the-dsp48e1-slice","n":6,"title":{"en":"The DSP48E1 slice","ru":"Слайс DSP48E1"},"goal":{"en":"How a product is tiled onto 25 x 18 multipliers and how many terms the 48-bit accumulator can sum.","ru":"Как произведение раскладывается на умножители 25 x 18 и сколько слагаемых может просуммировать 48-битный аккумулятор."},"frame":"widgets/dsp-fit/index.html?embed=1","widget":"The DSP48E1 slice: fit a x b and its running sum","height":760}]},{"n":3,"title":{"en":"Fixed point","ru":"Фиксированная точка"},"lessons":[{"id":"q-formats","n":7,"title":{"en":"Q formats","ru":"Форматы Q"},"goal":{"en":"How to read and write a Qm.n fixed-point word: its range, its step and the bits around the binary point.","ru":"Как читать и записывать слово Qm.n с фиксированной точкой: его диапазон, шаг и биты вокруг двоичной точки."},"frame":"widgets/q-format/index.html?embed=1","widget":"Q formats: read and write a fixed-point number","height":760},{"id":"rounding-and-saturation","n":8,"title":{"en":"Rounding and saturation","ru":"Округление и насыщение"},"goal":{"en":"What truncation, rounding and convergent rounding do to a value and to its average, and when to wrap or saturate.","ru":"Что усечение, округление и конвергентное округление делают со значением и с его средним и когда заворачивать, а когда насыщать."},"frame":"widgets/round-sat/index.html?embed=1","widget":"Rounding and saturation: the error you choose, and its bias","height":760},{"id":"quantization-noise","n":9,"title":{"en":"Quantization noise","ru":"Шум квантования"},"goal":{"en":"Why each bit of a quantizer buys about 6 dB, and where the textbook formula is optimistic.","ru":"Почему каждый бит квантователя даёт около 6 дБ и где формула из учебника слишком оптимистична."},"frame":"widgets/sqnr/index.html?embed=1","widget":"Quantization noise: each bit buys about 6 dB","height":760}]},{"n":4,"title":{"en":"Functions in hardware","ru":"Функции в железе"},"lessons":[{"id":"rotating-by-shifts","n":10,"title":{"en":"Rotating by shifts","ru":"Поворот сдвигами"},"goal":{"en":"How CORDIC rotation mode reaches cos and sin with nothing but shifts and adds.","ru":"Как режим вращения CORDIC получает cos и sin одними сдвигами и сложениями."},"frame":"widgets/cordic/index.html?embed=1","widget":"CORDIC: rotate a vector with shifts and adds","height":760},{"id":"angle-and-magnitude","n":11,"title":{"en":"Angle and magnitude","ru":"Угол и модуль"},"goal":{"en":"How CORDIC vectoring mode gives atan2 and the length of a vector without a divider.","ru":"Как режим векторизации CORDIC даёт atan2 и длину вектора без делителя."},"frame":"widgets/cordic-vector/index.html?embed=1","widget":"CORDIC vectoring: angle and length without a divide","height":760},{"id":"tables-and-interpolation","n":12,"title":{"en":"Tables and interpolation","ru":"Таблицы и интерполяция"},"goal":{"en":"How many sine table entries you need, and when linear interpolation beats more entries.","ru":"Сколько записей нужно таблице синуса и когда линейная интерполяция выгоднее лишних записей."},"frame":"widgets/sine-table/index.html?embed=1","widget":"Sine tables: entries, word width, and interpolation","height":760}]},{"n":5,"title":{"en":"Signals and sampling","ru":"Сигналы и дискретизация"},"lessons":[{"id":"sampling-and-aliasing","n":13,"title":{"en":"Sampling and aliasing","ru":"Дискретизация и наложение спектров"},"goal":{"en":"Why a tone above half the sample rate comes back as a lower one, and which way it folds.","ru":"Почему тон выше половины частоты дискретизации возвращается более низким и в какую сторону он отражается."},"frame":"widgets/alias-fold/index.html?embed=1","widget":"Sampling and aliasing: the fold of every frequency","height":760},{"id":"the-nco","n":14,"title":{"en":"A numerically controlled oscillator","ru":"Генератор с числовым управлением"},"goal":{"en":"How a phase accumulator and a sine table make any frequency, and how fine the steps are.","ru":"Как фазовый аккумулятор и таблица синуса дают любую частоту и насколько мелки её шаги."},"frame":"widgets/nco/index.html?embed=1","widget":"The NCO: a phase accumulator and a sine table","height":760},{"id":"bins-of-a-spectrum","n":15,"title":{"en":"Bins of a spectrum","ru":"Бины спектра"},"goal":{"en":"What one DFT bin measures, and why a tone between bins leaks into all of them.","ru":"Что измеряет один бин ДПФ и почему тон между бинами растекается по всем."},"frame":"widgets/dft-bin/index.html?embed=1","widget":"Bins of a spectrum: one tone, and where it leaks","height":760}]},{"n":6,"title":{"en":"FIR filters","ru":"Фильтры FIR"},"lessons":[{"id":"the-moving-average","n":16,"title":{"en":"The moving average","ru":"Скользящее среднее"},"goal":{"en":"Why averaging L samples is a low-pass filter, and where its nulls fall.","ru":"Почему усреднение L отсчётов — фильтр нижних частот и где лежат его нули."},"frame":"widgets/fir-response/index.html?embed=1","widget":"The moving average: a low-pass you can do in your head","height":760},{"id":"designing-taps","n":17,"title":{"en":"Designing taps","ru":"Расчёт коэффициентов"},"goal":{"en":"How a windowed-sinc low-pass is designed, and what rounding its taps to integers costs.","ru":"Как рассчитывается ФНЧ окном sinc и чего стоит округление его коэффициентов до целых."},"frame":"widgets/fir-design/index.html?embed=1","widget":"Designing FIR taps: a window, a cutoff, and the bits you keep","height":760},{"id":"folding-taps-onto-slices","n":18,"title":{"en":"Folding taps onto slices","ru":"Раскладка отводов по слайсам"},"goal":{"en":"How symmetry and a fast clock cut the DSP slices a FIR needs.","ru":"Как симметрия и быстрый такт сокращают число слайсов DSP, нужных фильтру FIR."},"frame":"widgets/fir-cost/index.html?embed=1","widget":"Folding a FIR onto DSP slices","height":760}]},{"n":7,"title":{"en":"Multirate","ru":"Многоскоростная обработка"},"lessons":[{"id":"lowering-the-rate","n":19,"title":{"en":"Lowering the rate","ru":"Понижение частоты"},"goal":{"en":"What keeping every R-th sample does to the spectrum, and which frequencies fold onto the band you keep.","ru":"Что сохранение каждого R-го отсчёта делает со спектром и какие частоты заворачиваются в оставляемую полосу."},"frame":"widgets/decimator/index.html?embed=1","widget":"Decimation: lower the rate without folding noise in","height":760},{"id":"the-cic-filter","n":20,"title":{"en":"The CIC filter","ru":"Фильтр CIC"},"goal":{"en":"How a CIC decimator filters with no multipliers, and how many bits its registers must grow.","ru":"Как дециматор CIC фильтрует без умножителей и на сколько бит должны вырасти его регистры."},"frame":"widgets/cic-growth/index.html?embed=1","widget":"The CIC filter: no multipliers, many bits","height":760},{"id":"polyphase","n":21,"title":{"en":"Polyphase","ru":"Полифазная форма"},"goal":{"en":"How the polyphase form does the filtering of a decimator at the low rate.","ru":"Как полифазная форма выполняет фильтрацию дециматора на низкой частоте."},"frame":"widgets/polyphase/index.html?embed=1","widget":"Polyphase: do the work at the low rate","height":760}]},{"n":8,"title":{"en":"The FFT","ru":"БПФ"},"lessons":[{"id":"the-butterfly","n":22,"title":{"en":"The butterfly","ru":"Бабочка"},"goal":{"en":"How a radix-2 FFT breaks a DFT into stages of butterflies, and what that saves.","ru":"Как БПФ по основанию 2 разбивает ДПФ на этапы бабочек и что это экономит."},"frame":"widgets/fft-butterfly/index.html?embed=1","widget":"The FFT butterfly: N log N instead of N^2","height":760},{"id":"twiddles-and-bit-reversal","n":23,"title":{"en":"Twiddles and bit reversal","ru":"Поворачивающие множители и бит-реверс"},"goal":{"en":"Why a decimation-in-time FFT takes its input in bit-reversed order, and where the twiddles come from.","ru":"Почему БПФ с прореживанием по времени берёт вход в бит-реверсном порядке и откуда берутся поворачивающие множители."},"frame":"widgets/bit-reverse/index.html?embed=1","widget":"Bit reversal: the order an FFT reads its input in","height":760},{"id":"growth-through-the-stages","n":24,"title":{"en":"Growth through the stages","ru":"Рост через этапы"},"goal":{"en":"How many bits the words of an FFT grow, and what halving every stage holds back and what it loses.","ru":"На сколько бит растут слова БПФ и что удерживает и чего лишает деление пополам на каждом этапе."},"frame":"widgets/fft-scaling/index.html?embed=1","widget":"FFT word growth: how many bits each stage adds","height":760}]},{"n":9,"title":{"en":"On the bench","ru":"На стенде"},"lessons":[{"id":"a-correlator-finds-the-frame","n":25,"title":{"en":"A correlator finds the frame","ru":"Коррелятор находит кадр"},"goal":{"en":"How a Barker-13 correlator finds the start of a frame, and how many flipped chips it survives.","ru":"Как коррелятор Баркера-13 находит начало кадра и сколько перевёрнутых чипов он выдерживает."},"frame":"widgets/barker-corr/index.html?embed=1","widget":"A correlator finds the frame: Barker-13 in a stream of chips","height":760},{"id":"does-it-fit-and-close-timing","n":26,"title":{"en":"Does it fit and close timing?","ru":"Помещается ли и сходится ли тайминг?"},"goal":{"en":"How to budget DSP slices for a multichannel filter, and why the adder tree, not the multiplier, misses timing.","ru":"Как составить бюджет слайсов DSP для многоканального фильтра и почему тайминг срывает дерево сумматоров, а не умножитель."},"frame":"widgets/fir-fit/index.html?embed=1","widget":"Does it fit, and does it close timing?","height":760},{"id":"capstone-a-filter-on-the-board","n":27,"title":{"en":"Capstone: a filter on the board","ru":"Итог: фильтр на плате"},"goal":{"en":"How the arithmetic of the course meets in one filter, computed bit for bit the way the board computes it.","ru":"Как арифметика курса сходится в одном фильтре, посчитанном бит в бит так, как считает плата."},"frame":"widgets/fir-on-board/index.html?embed=1","widget":"Capstone: a filter as the board computes it","height":760}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/buses-and-peripherals.json b/apps/website/public/widgets/course-deck/courses/buses-and-peripherals.json new file mode 100644 index 0000000000..8022c87502 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/buses-and-peripherals.json @@ -0,0 +1 @@ +{"id":"buses-and-peripherals","route":"buses-and-peripherals","title":{"en":"Buses and peripherals with t27: UART, SPI, APB, AXI4, Ethernet","ru":"Шины и периферия на t27: UART, SPI, APB, AXI4, Ethernet"},"onePage":{"en":"/learn/buses-and-peripherals/all/","ru":"/ru/learn/buses-and-peripherals/all/"},"modules":[{"n":1,"title":{"en":"What a bus is","ru":"Что такое шина"},"lessons":[{"id":"wires-that-talk","n":1,"title":{"en":"Wires that talk","ru":"Провода, которые говорят"},"goal":{"en":"What a bus is for, what the two-wire conversation of a UART costs, and what the course's opening spec checks.","ru":"Зачем нужна шина, сколько стоит двухпроводный разговор UART и что проверяет спека, открывающая курс."},"frame":"term/t27c-check-uart/index.html","widget":"t27c check on uart.t27 -- the spec compiles","height":640},{"id":"framing-a-conversation","n":2,"title":{"en":"Framing a conversation","ru":"Кадрирование разговора"},"goal":{"en":"What a clocked conversation changes, and how the SPI spec states its modes and rates.","ru":"Что меняет разговор под тактом и как спека SPI описывает свои режимы и частоты."},"frame":"term/t27c-check-spi/index.html","widget":"t27c check on spi.t27 -- the spec compiles","height":640},{"id":"master-and-servant","n":3,"title":{"en":"Master and servant","ru":"Хозяин и слуга"},"goal":{"en":"What a register bus is, who drives and who answers, and how APB names the roles.","ru":"Что такое шина регистров, кто ведёт и кто отвечает, и как APB называет роли."},"frame":"term/t27c-check-apb/index.html","widget":"t27c check on apb_bridge.t27 -- the spec compiles","height":640}]},{"n":2,"title":{"en":"UART","ru":"Разговор по UART"},"lessons":[{"id":"the-frame","n":4,"title":{"en":"The frame: start, data, stop","ru":"Кадр: старт, данные, стоп"},"goal":{"en":"How a UART frame is built bit by bit, and what the compiler emits for it.","ru":"Как побитово собирается кадр UART и что компилятор порождает для него."},"frame":"term/t27c-verilog-uart/index.html","widget":"t27c gen-verilog on uart.t27 -- spec to RTL","height":640},{"id":"baud-and-the-divisor","n":5,"title":{"en":"Baud and the divisor","ru":"Бод и делитель"},"goal":{"en":"How one divisor turns a clock into a bit rate, and what changing it breaks.","ru":"Как один делитель превращает такт в скорость битов и что ломает его смену."},"frame":"term/t27c-hir-uart/index.html","widget":"t27c debug-hir on uart.t27 -- the bus as the compiler sees it","height":640},{"id":"status-and-fifos","n":6,"title":{"en":"Status and FIFOs","ru":"Статус и FIFO"},"goal":{"en":"What a driver polls, when a send is refused, and what the testbench of the UART checks.","ru":"Что опрашивает драйвер, когда отправка отвергается и что проверяет тестбенч UART."},"frame":"term/t27c-verilog-uart-tb/index.html","widget":"t27c gen-verilog on uart_tb.t27 -- the testbench as RTL","height":640}]},{"n":3,"title":{"en":"SPI","ru":"SPI под тактом"},"lessons":[{"id":"modes-cpol-cpha","n":7,"title":{"en":"Modes: CPOL and CPHA","ru":"Режимы: CPOL и CPHA"},"goal":{"en":"What CPOL and CPHA mean, why there are four modes, and which one the spec configures.","ru":"Что значат CPOL и CPHA, почему режимов четыре и какой конфигурирует спека."},"frame":"term/t27c-verilog-spi/index.html","widget":"t27c gen-verilog on spi.t27 -- spec to RTL","height":640},{"id":"the-prescaler-ladder","n":8,"title":{"en":"The prescaler ladder","ru":"Лестница предделителей"},"goal":{"en":"How the prescaler ladder turns one clock into a family of SCK rates, and which steps are valid.","ru":"Как лестница предделителей превращает один такт в семейство частот SCK и какие ступени допустимы."},"frame":"term/t27c-spi-tb/index.html","widget":"t27c on spi_tb.t27 -- simulating the SPI testbench","height":640},{"id":"chip-select-and-widths","n":9,"title":{"en":"Chip select and widths","ru":"Выбор кристалла и ширины"},"goal":{"en":"How a chip select picks the listener, and how wide a transfer may be.","ru":"Как выбор кристалла указывает слушателя и какой ширины бывает обмен."},"frame":"term/t27c-verilog-spi-tb/index.html","widget":"t27c gen-verilog on spi_tb.t27 -- the testbench as RTL","height":640}]},{"n":4,"title":{"en":"APB","ru":"Регистровая шина APB"},"lessons":[{"id":"psel-and-penable","n":10,"title":{"en":"PSEL and PENABLE","ru":"PSEL и PENABLE"},"goal":{"en":"How the APB two-phase handshake works, and what the compiler emits for the bridge.","ru":"Как работает двухфазное рукопожатие APB и что компилятор порождает для моста."},"frame":"term/t27c-verilog-apb/index.html","widget":"t27c gen-verilog on apb_bridge.t27 -- spec to RTL","height":640},{"id":"strobes-and-waits","n":11,"title":{"en":"Strobes and waits","ru":"Строобы и ожидания"},"goal":{"en":"What the strobe bytes mean, when a servant holds the bus, and how the IR sees it.","ru":"Что значат байты строоба, когда слуга держит шину и как это видит IR."},"frame":"term/t27c-hir-apb/index.html","widget":"t27c debug-hir on apb_bridge.t27 -- the handshake as IR","height":640},{"id":"address-decode","n":12,"title":{"en":"Address decode","ru":"Дешифрация адреса"},"goal":{"en":"How many address bits a peripheral count costs, and what the bench of the bridge checks.","ru":"Сколько адресных бит стоит количество периферии и что проверяет стенд моста."},"frame":"term/t27c-verilog-apb-tb/index.html","widget":"t27c gen-verilog on apb_bridge_tb.t27 -- the testbench as RTL","height":640}]},{"n":5,"title":{"en":"AXI4","ru":"Пять каналов AXI4"},"lessons":[{"id":"five-channels","n":13,"title":{"en":"Five channels","ru":"Пять каналов"},"goal":{"en":"What the five AXI4 channels carry, and what the compiler emits for them.","ru":"Что несут пять независимых каналов AXI4 и что компилятор порождает для них."},"frame":"term/t27c-verilog-axi4/index.html","widget":"t27c gen-verilog on axi4.t27 -- spec to RTL","height":640},{"id":"lite-or-full","n":14,"title":{"en":"Lite or full","ru":"Lite или full"},"goal":{"en":"What AXI4 Lite keeps and drops, and what validation demands of a bus.","ru":"Что AXI4 Lite оставляет и что выбрасывает, и чего валидация требует от шины."},"frame":"term/t27c-check-axi4/index.html","widget":"t27c check on axi4.t27 -- the spec compiles","height":640},{"id":"bursts-and-ids","n":15,"title":{"en":"Bursts and IDs","ru":"Пакеты и идентификаторы"},"goal":{"en":"How a burst is described, what an ID is for, and what the AXI4 bench checks.","ru":"Как описывается пакет, зачем нужен ID и что проверяет стенд AXI4."},"frame":"term/t27c-verilog-axi-tb/index.html","widget":"t27c gen-verilog on axi4_tb.t27 -- the testbench as RTL","height":640}]},{"n":6,"title":{"en":"Memory","ru":"Память"},"lessons":[{"id":"memory-maps","n":16,"title":{"en":"Memory maps","ru":"Карты памяти"},"goal":{"en":"How a memory map is declared, what BRAM and ROM mean as kinds, and what 15 native tests check.","ru":"Как объявляется карта памяти, что значат BRAM и ROM как типы и что проверяют 15 нативных тестов."},"frame":"term/t27c-memory/index.html","widget":"t27c on memory.t27 -- the memory map, native","height":640},{"id":"ports-and-kinds","n":17,"title":{"en":"Ports and kinds","ru":"Порты и типы"},"goal":{"en":"What a port is on a memory, how many a memory may have, and who may write.","ru":"Что такое порт у памяти, сколько их может быть и кому позволено писать."},"frame":"term/t27c-check-memory/index.html","widget":"t27c check on memory.t27 -- the spec compiles","height":640},{"id":"latency","n":18,"title":{"en":"Latency","ru":"Задержка"},"goal":{"en":"What latency a memory answers in, and what the memory bench checks of reads and writes.","ru":"В скольких тактах память отвечает и что стенд памяти проверяет в чтении и записи."},"frame":"term/t27c-verilog-mem-tb/index.html","widget":"t27c gen-verilog on memory_tb.t27 -- the testbench as RTL","height":640}]},{"n":7,"title":{"en":"Bridges","ru":"Мосты"},"lessons":[{"id":"why-bridges","n":19,"title":{"en":"Why bridges","ru":"Зачем мосты"},"goal":{"en":"Why a design grows more than one bus, and what the bridge spec checks of its own state.","ru":"Почему в дизайне появляется больше одной шины и что спека моста проверяет о собственном состоянии."},"frame":"term/t27c-check-bridge/index.html","widget":"t27c check on bridge.t27 -- the spec compiles","height":640},{"id":"the-packet-bridge","n":20,"title":{"en":"The packet bridge","ru":"Пакетный мост"},"goal":{"en":"How the packet bridge moves work between buses, and what its buffers cost.","ru":"Как пакетный мост переносит работу между шинами и чего стоят его буферы."},"frame":"term/t27c-verilog-bridge/index.html","widget":"t27c gen-verilog on bridge.t27 -- spec to RTL","height":640},{"id":"everything-in-one-bench","n":21,"title":{"en":"Everything in one bench","ru":"Всё в одном стенде"},"goal":{"en":"What an integration bench checks when every bus of the design is driven at once.","ru":"Что проверяет интеграционный стенд, когда все шины дизайна гоняются одновременно."},"frame":"term/t27c-verilog-integration-tb/index.html","widget":"t27c gen-verilog on integration_tb.t27 -- the integration bench","height":640}]},{"n":8,"title":{"en":"Ethernet","ru":"Ethernet: кадры и тайминг"},"lessons":[{"id":"frames-and-the-fcs","n":22,"title":{"en":"Frames and the FCS","ru":"Кадры и контрольная сумма"},"goal":{"en":"How an Ethernet frame ends in a CRC-32, and what the check computes.","ru":"Как кадр Ethernet заканчивается CRC-32 и что вычисляет проверка."},"frame":"term/t27c-eth-crc/index.html","widget":"t27c on eth_crc.t27 -- the FCS, native","height":640},{"id":"rgmii-timing","n":23,"title":{"en":"RGMII timing","ru":"Тайминг RGMII"},"goal":{"en":"What RGMII timing demands of a double-data-rate nibble, and what the spec asserts of it.","ru":"Что тайминг RGMII требует от полубайта на двух фронтах и что спека о нём утверждает."},"frame":"term/t27c-rgmii/index.html","widget":"t27c on rgmii.t27 -- RGMII timing, native","height":640},{"id":"bring-up-on-the-bench","n":24,"title":{"en":"Bring-up on the bench","ru":"Запуск на стенде"},"goal":{"en":"What a pre-registered bring-up looks like on the real bench, step by step.","ru":"Как выглядит заранее зарегистрированный запуск на настоящем стенде, шаг за шагом."},"frame":"term/tri-fpga-steps/index.html","widget":"tri fpga-steps E3","height":640}]},{"n":9,"title":{"en":"The bench","ru":"Стенд"},"lessons":[{"id":"who-holds-the-io","n":25,"title":{"en":"Who holds the IO","ru":"Кто держит IO"},"goal":{"en":"Who holds the bench IO right now, and what the registered clients declare.","ru":"Кто сейчас держит IO стенда и что заявляют зарегистрированные клиенты."},"frame":"term/tri-fpga-ioclients/index.html","widget":"tri fpga-ioclients -- who holds the bench IO","height":640},{"id":"claim-and-release","n":26,"title":{"en":"Claim and release","ru":"Захват и возврат"},"goal":{"en":"How a claim is taken and given back, and why the discipline matters.","ru":"Как берётся и возвращается захват и почему дисциплина важна."},"frame":"term/tri-fpga-claim/index.html","widget":"tri fpga-claim -- taking the bench lock","height":640},{"id":"capstone-what-runs-next","n":27,"title":{"en":"Capstone: what runs next","ru":"Капстоун: что запускается дальше"},"goal":{"en":"How the pieces of this course meet in one design, and what runs next on the bench.","ru":"Как куски курса сходятся в один дизайн и что запускается на стенде дальше."},"frame":"term/tri-fpga-next/index.html","widget":"tri fpga-next -- what the bench wants next","height":640}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/clocks-and-cdc.json b/apps/website/public/widgets/course-deck/courses/clocks-and-cdc.json new file mode 100644 index 0000000000..7a05b63767 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/clocks-and-cdc.json @@ -0,0 +1 @@ +{"id":"clocks-and-cdc","route":"clocks-and-cdc","title":{"en":"Clocking, resets and clock-domain crossings with t27","ru":"Тактирование, сброс и пересечения тактовых доменов на t27"},"onePage":{"en":"/learn/clocks-and-cdc/all/","ru":"/ru/learn/clocks-and-cdc/all/"},"modules":[{"n":1,"title":{"en":"What a clock is","ru":"Что такое тактовый сигнал"},"lessons":[{"id":"one-edge-one-world","n":1,"title":{"en":"One edge, one world","ru":"Один фронт, один мир"},"goal":{"en":"What a clock domain is, the four ways clock_domain.t27 names to cross one, and what the native compiler checks of them.","ru":"Что такое тактовый домен, четыре названных в clock_domain.t27 способа его пересечь и что проверяет нативный компилятор."},"frame":"term/t27c-clock-domain/index.html","widget":"t27c on clock_domain.t27 -- the CDC spec, native","height":640},{"id":"period-and-jitter","n":2,"title":{"en":"A period, an edge, and jitter","ru":"Период, фронт и джиттер"},"goal":{"en":"What a clock carries besides frequency, what jitter does to an edge, and what a tool-card spec is for.","ru":"Что несёт тактовый сигнал кроме частоты, что джиттер делает с фронтом и зачем нужна спека карточки инструмента."},"frame":"term/t27c-clocks/index.html","widget":"t27c on clocks.t27 -- the tri clocks card, native","height":640},{"id":"where-the-clock-enters","n":3,"title":{"en":"Where the clock enters","ru":"Где входит тактовый сигнал"},"goal":{"en":"Where a board's clock really comes from, and how a ring oscillator inside the chip was measured on three dice over JTAG.","ru":"Откуда на самом деле берётся тактовый сигнал платы и как кольцевой генератор внутри кристалла измерили на трёх кристаллах через JTAG."},"frame":"term/t27c-wukong-v1/index.html","widget":"t27c on wukong_v1.t27 -- the board spec, native","height":640}]},{"n":2,"title":{"en":"Clock trees","ru":"Деревья тактового сигнала"},"lessons":[{"id":"skew-and-insertion","n":4,"title":{"en":"Skew and insertion delay","ru":"Перекос и задержка прохождения"},"goal":{"en":"Why the clock does not reach every flop at once, and what the tree delays of a 7-series chip cost.","ru":"Почему тактовый сигнал не доходит до всех триггеров одновременно и чего стоят задержки дерева кристалла 7-й серии."},"frame":"term/t27c-cts/index.html","widget":"t27c on cts.t27 -- clock-tree synthesis, native","height":640},{"id":"global-buffers","n":5,"title":{"en":"The global buffer","ru":"Глобальный буфер"},"goal":{"en":"What a global buffer is, why it sits on its own network, and what one real build of the whole flow looked like.","ru":"Что такое глобальный буфер, почему он живёт в собственной сети и как выглядела одна настоящая сборка всего потока."},"frame":"term/tri-game-selftest/index.html","widget":"tri game-selftest: the queen loop checks its own tools","height":640},{"id":"gated-clock-trap","n":6,"title":{"en":"The gated-clock trap","ru":"Ловушка стробированного клока"},"goal":{"en":"Why gating a clock with logic makes a new domain, and what a clock enable is for.","ru":"Почему стробирование клока логикой создаёт новый домен и зачем нужен clock enable."},"frame":"widgets/race-the-bee/index.html?embed=1","widget":"Race the bee: who lands patches on t27, a person or a bee","height":640}]},{"n":3,"title":{"en":"PLL and MMCM","ru":"PLL и MMCM"},"lessons":[{"id":"multiply-and-divide","n":7,"title":{"en":"Multiply and divide","ru":"Умножить и поделить"},"goal":{"en":"How the MMCM turns one clock into another by multiply and divide, and which windows the numbers must land in.","ru":"Как MMCM превращает один тактовый сигнал в другой умножением и делением и в какие окна должны попасть числа."},"frame":"term/t27c-mmcm/index.html","widget":"t27c on mmcm.t27 -- the MMCM model, native","height":640},{"id":"phase-and-lock","n":8,"title":{"en":"Phase and lock","ru":"Фаза и захват"},"goal":{"en":"How fine the phase knob is, how the lock model behaves, and what one widened window breaks.","ru":"Насколько мелкая ручка фазы, как ведёт себя модель захвата и что ломает одно расширенное окно."},"frame":"term/t27c-mmcm-mutate/index.html","widget":"t27c on mmcm.t27 -- widen the VCO window, one test objects","height":640},{"id":"related-or-not","n":9,"title":{"en":"Related or not","ru":"Родственные или чужие"},"goal":{"en":"When the analyzer checks a path between two clocks and when it must be told they are strangers.","ru":"Когда анализатор проверяет путь между двумя тактовыми сигналами и когда ему надо сказать, что они чужие."},"frame":"term/t27c-timing/index.html","widget":"t27c on timing.t27 -- static timing, native","height":640}]},{"n":4,"title":{"en":"Resets","ru":"Сбросы"},"lessons":[{"id":"sync-or-async","n":10,"title":{"en":"Sync or async","ru":"Синхронный или асинхронный"},"goal":{"en":"The three reset kinds, which one races the clock, and the shape the course recommends.","ru":"Три вида сброса, какой из них гонится с клоком и какую форму рекомендует курс."},"frame":"term/t27c-reset-sync/index.html","widget":"t27c on reset_sync.t27 -- the reset kinds, native","height":640},{"id":"reset-release","n":11,"title":{"en":"The release pipe","ru":"Конвейер снятия"},"goal":{"en":"How a reset release walks a shift register, and what the compiler emits for it.","ru":"Как снятие сброса проходит по сдвиговому регистру и что компилятор для него генерирует."},"frame":"term/t27c-reset-sync-gen/index.html","widget":"t27c gen on reset_sync.t27 -- the release pipe as Zig","height":640},{"id":"reset-fanout","n":12,"title":{"en":"Reset fanout","ru":"Разветвление сброса"},"goal":{"en":"Why a reset grows a tree like a clock, and where its cost shows up in a real resource count.","ru":"Почему сброс растит дерево, как тактовое, и где его цена видна в настоящем подсчёте ресурсов."},"frame":"term/tri-fpga-rxcap/index.html","widget":"tri fpga-rxcap","height":640}]},{"n":5,"title":{"en":"Metastability","ru":"Метастабильность"},"lessons":[{"id":"setup-hold-window","n":13,"title":{"en":"The setup-hold window","ru":"Окно setup-hold"},"goal":{"en":"What setup and hold mean, what a flop does when the window is missed, and what a VCD shows of it.","ru":"Что значат setup и hold, что делает триггер при попадании в окно и что показывает из этого VCD."},"frame":"term/tri-fpga-rxer/index.html","widget":"tri fpga-rxer","height":640},{"id":"mtbf","n":14,"title":{"en":"Mean time between failures","ru":"Среднее время между отказами"},"goal":{"en":"How MTBF prices a crossing in integer log2 arithmetic, and which constants are assumptions.","ru":"Как MTBF назначает пересечению цену в целочисленной арифметике log2 и какие константы в ней допущения."},"frame":"term/t27c-mtbf/index.html","widget":"t27c on mtbf.t27 -- MTBF in integer log2, native","height":640},{"id":"two-flop-sync","n":15,"title":{"en":"The two-flop synchronizer","ru":"Двухтриггерный синхронизатор"},"goal":{"en":"Why two flops are the fix, and what the generated model of the crossing looks like.","ru":"Почему два триггера — это лекарство и как выглядит сгенерированная модель пересечения."},"frame":"term/t27c-clock-domain-gen/index.html","widget":"t27c gen on clock_domain.t27 -- the CDC model as Zig","height":640}]},{"n":6,"title":{"en":"Crossing many bits","ru":"Пересечение многих бит"},"lessons":[{"id":"why-binary-fails","n":16,"title":{"en":"Why binary fails","ru":"Почему двоичный код рвётся"},"goal":{"en":"Why sampling a binary bus mid-change tears it, and what the FIFO spec checks of its pointers.","ru":"Почему сэмплирование двоичной шины в другом домене рвёт её и что спека FIFO проверяет у указателей."},"frame":"term/t27c-fifo/index.html","widget":"t27c on fifo.t27 -- the FIFO stdlib, native","height":640},{"id":"gray-code","n":17,"title":{"en":"Gray code","ru":"Код Грея"},"goal":{"en":"Why Gray code changes one bit at a time, and what a test suite that never reads pointers cannot see.","ru":"Почему код Грея меняет по одному биту за шаг и чего не может увидеть набор тестов, не читающий указатели."},"frame":"term/t27c-fifo-mutate/index.html","widget":"t27c on fifo.t27 -- a pointer mutation the tests cannot see","height":640},{"id":"handshakes-and-pulses","n":18,"title":{"en":"Handshakes and pulses","ru":"Рукопожатия и импульсы"},"goal":{"en":"How a handshake moves a pulse between worlds, and what an edge-driven report and a toggle synchronizer share.","ru":"Как рукопожатие переносит импульс между мирами и что общего у отчёта по фронтам и тоггл-синхронизатора."},"frame":"term/tri-game-tick/index.html","widget":"tri game-tick: one anomaly scan, only what changed","height":640}]},{"n":7,"title":{"en":"The asynchronous FIFO","ru":"Асинхронный FIFO"},"lessons":[{"id":"pointers-and-flags","n":19,"title":{"en":"Pointers and flags","ru":"Указатели и флаги"},"goal":{"en":"How the flags are derived from the pointers, which signals actually cross, and what one flipped assignment breaks.","ru":"Как флаги выводятся из указателей, какие сигналы на самом деле пересекают границу и что ломает одно переприсваивание."},"frame":"term/t27c-fifo-flags/index.html","widget":"t27c on fifo.t27 -- break a flag, one test objects","height":640},{"id":"depth-sizing","n":20,"title":{"en":"Sizing the depth","ru":"Выбор глубины"},"goal":{"en":"How depth follows from the write rate, the read rate and the worst burst, and what a real timed loop measures.","ru":"Как глубина следует из скорости записи, скорости чтения и худшей пачки и что измеряет настоящий хронометрированный цикл."},"frame":"term/t27-tri-competitors/index.html","widget":"tri competitors audit: the table, audited","height":640},{"id":"fifo-testbench","n":21,"title":{"en":"The FIFO testbench","ru":"Тестбенч FIFO"},"goal":{"en":"What a testbench discipline looks like when it is real, and why this lesson opens the FIFO spec and a mutation recording instead.","ru":"Как выглядит настоящая дисциплина тестбенча и почему этот урок открывает спеку FIFO и запись мутаций."},"frame":"term/t27-tri-discard/index.html","widget":"tri discard top: what the parser throws away","height":640}]},{"n":8,"title":{"en":"Constraints","ru":"Ограничения"},"lessons":[{"id":"create-clock","n":22,"title":{"en":"create_clock","ru":"Строка create_clock"},"goal":{"en":"What the create_clock line tells the analyzer, and which spec writes it.","ru":"Что строка create_clock сообщает анализатору и какая спека её пишет."},"frame":"term/t27c-emitter-xdc/index.html","widget":"t27c on emitter_xdc.t27 -- the XDC emitter, parsed","height":640},{"id":"false-path-and-max-delay","n":23,"title":{"en":"False paths and max delay","ru":"False path и max delay"},"goal":{"en":"What a false path declares, what a max delay bounds instead, and what removing a check looks like in a repository.","ru":"Что объявляет false path, что вместо этого ограничивает max delay и как выглядит удаление проверки в репозитории."},"frame":"term/tri-fpga-txhold/index.html","widget":"tri fpga-txhold: setup and hold from the routed SDF","height":640},{"id":"io-timing","n":24,"title":{"en":"IO timing","ru":"Тайминг выводов"},"goal":{"en":"How IO timing is stated against a clock another chip drives, and what margins read from an SDF look like.","ru":"Как тайминг выводов задаётся против клока, которым управляет другая микросхема, и как выглядят запасы, прочитанные из SDF."},"frame":"term/tri-fpga-rgmii/index.html","widget":"tri fpga-txhold · RGMII margins from nextpnr's own SDF","height":640}]},{"n":9,"title":{"en":"On the board","ru":"На плате"},"lessons":[{"id":"cdc-report","n":25,"title":{"en":"The CDC report","ru":"Отчёт CDC"},"goal":{"en":"What a CDC report lists and asks of every crossing, and what a report of verified things has in common with it.","ru":"Что перечисляет отчёт CDC и о чём спрашивает каждое пересечение, и что общего у него с отчётом проверенных вещей."},"frame":"term/tri-game-vault/index.html","widget":"tri game-vault: the loop's skills checked against snapshots","height":640},{"id":"capture-a-crossing","n":26,"title":{"en":"Capture a crossing","ru":"Захватить пересечение"},"goal":{"en":"How one crossing was captured at the flip-flops on a real board, and what the recorded run printed.","ru":"Как захватили одно пересечение в точке, где оно приземляется: на самих RX-приёмных триггерах, и что напечатал записанный запуск."},"frame":"term/t27c-fpga-rxcap/index.html","widget":"t27c on fpga-rxcap.t27 -- the RX capture card, native","height":640},{"id":"capstone-diff","n":27,"title":{"en":"Capstone: change it and diff it","ru":"Капстоун: поменяй и сравни"},"goal":{"en":"How the pieces of this course meet in one build, and what a bitstream diff says about a change.","ru":"Как куски курса сходятся в одной сборке и что говорит дифф битстрима об изменении."},"frame":"term/tri-blog-list/index.html","widget":"tri blog list: every t27.ai post and its receipt state","height":640}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/course.json b/apps/website/public/widgets/course-deck/courses/course.json new file mode 100644 index 0000000000..bfd7706410 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/course.json @@ -0,0 +1 @@ +{"id":"course","route":"course","title":{"en":"From zero to a chip: FPGA programming with t27","ru":"С нуля до чипа: программирование FPGA на t27"},"onePage":{"en":"/learn/course/all/","ru":"/ru/learn/course/all/"},"modules":[{"n":1,"title":{"en":"The chip","ru":"Чип"},"lessons":[{"id":"fpga-is-a-grid","n":1,"title":{"en":"An FPGA is a grid you configure","ru":"FPGA — это сетка, которую вы настраиваете"},"goal":{"en":"What an FPGA is made of, and why a design uses only part of the chip.","ru":"Из чего состоит FPGA и почему дизайн занимает только часть чипа."},"frame":"widgets/fasm-skyline/index.html?embed=1","widget":"FASM skyline: a routed 7-series design as a city on the XC7A200T die","height":640},{"id":"which-chip","n":2,"title":{"en":"Which chip is this?","ru":"Какой это чип?"},"goal":{"en":"How a chip names itself in 32 bits, and how to read those bits.","ru":"Как чип называет себя в 32 битах и как эти биты читать."},"frame":"widgets/idcode/index.html?embed=1","widget":"JTAG IDCODE decoder: 32 bits, four fields, one device","height":640},{"id":"pins-and-package","n":3,"title":{"en":"Pins, balls and the package","ru":"Выводы, шарики и корпус"},"goal":{"en":"How the signals of your design reach the outside world.","ru":"Как сигналы вашего дизайна попадают во внешний мир."},"frame":"widgets/pin-map/index.html?embed=1","widget":"Pin map: the XC7A200T FGG676 package ball by ball, with an XDC lint","height":640}]},{"n":2,"title":{"en":"Numbers in hardware","ru":"Числа в железе"},"lessons":[{"id":"bits-and-trits","n":4,"title":{"en":"Bits, trits and GF16","ru":"Биты, триты и GF16"},"goal":{"en":"How a number is stored in bits, and how balanced ternary stores it in trits.","ru":"Как число хранится в битах и как сбалансированная троичная система хранит его в тритах."},"frame":"widgets/gf16-calc/index.html?embed=1","widget":"GF16 calculator: a number as 16 GoldenFloat bits and as ternary","height":640},{"id":"what-arithmetic-costs","n":5,"title":{"en":"What arithmetic costs","ru":"Сколько стоит арифметика"},"goal":{"en":"Why a multiplier is expensive and an adder is cheap, measured on a real chip.","ru":"Почему умножитель дорогой, а сумматор дешёвый, — по измерениям на настоящем чипе."},"frame":"widgets/cost-curves/index.html?embed=1","widget":"Cost curves: adders, multipliers and MACs on a Xilinx 7-series","height":640},{"id":"how-much-fits","n":6,"title":{"en":"How much fits on the chip","ru":"Сколько помещается на чип"},"goal":{"en":"How to read a resource count and find which resource runs out first.","ru":"Как читать подсчёт ресурсов и находить, какой ресурс кончится раньше."},"frame":"widgets/fits-on/index.html?embed=1","widget":"Fits on a 200T: how many copies of your design an XC7A200T holds","height":640}]},{"n":3,"title":{"en":"Your t27 program","ru":"Ваша программа на t27"},"lessons":[{"id":"hello-t27","n":7,"title":{"en":"Hello, t27","ru":"Привет, t27"},"goal":{"en":"What a t27 spec looks like, and what the compiler does with it in your browser.","ru":"Как выглядит спека t27 и что с ней делает компилятор прямо в вашем браузере."},"frame":"play/embed.html?spec=specs%2Fdemos%2Fhello_world.t27&cast=t27c-hello-world&v=7cbe9ab0c960","widget":"hello_world.t27, compiled inside the post","height":480},{"id":"tests-are-the-spec","n":8,"title":{"en":"Tests are part of the spec","ru":"Тесты — часть спеки"},"goal":{"en":"Why every t27 spec carries its own tests, and what a waveform shows.","ru":"Почему каждая спека t27 несёт свои тесты и что показывает временная диаграмма."},"frame":"widgets/test-waves/index.html?embed=1","widget":"Test waves: a t27 spec's tests, simulated and drawn as waves","height":640},{"id":"compiles-is-not-correct","n":9,"title":{"en":"Compiles is not the same as correct","ru":"Компилируется — не значит верно"},"goal":{"en":"Why green checks are not proof, and how to catch code that compiles and is wrong.","ru":"Почему зелёные галочки — не доказательство и как поймать код, который компилируется и неверен."},"frame":"term/t27-tri-misread/index.html","widget":"tri misread: code that compiles and is wrong","height":640}]},{"n":4,"title":{"en":"Inside t27c","ru":"Внутри t27c"},"lessons":[{"id":"compiler-stages","n":10,"title":{"en":"The stages of t27c","ru":"Стадии t27c"},"goal":{"en":"The path a spec takes inside t27c: tokens, syntax tree, types, HIR, code.","ru":"Путь спеки внутри t27c: токены, синтаксическое дерево, типы, HIR, код."},"frame":"widgets/t27c-stages/index.html?embed=1","widget":"Inside t27c: watch a compiler read your code, stage by stage","height":640},{"id":"t27c-on-a-real-machine","n":11,"title":{"en":"t27c on a real machine","ru":"t27c на настоящей машине"},"goal":{"en":"The same compiler on a real machine, printing what it really prints.","ru":"Тот же компилятор на настоящей машине, печатающий то, что он действительно печатает."},"frame":"term/t27c-hello-world/index.html","widget":"t27c on hello_world.t27","height":640},{"id":"seven-backends-and-t27b","n":12,"title":{"en":"Seven backends, and t27b","ru":"Семь бэкендов и t27b"},"goal":{"en":"One spec, many target languages, and a native compiler with no LLVM.","ru":"Одна спека, много целевых языков и нативный компилятор без LLVM."},"frame":"play/embed.html?spec=specs%2Fdemos%2Fhello_world.t27&cast=t27c-hello-world&tab=term&backend=rust&v=7cbe9ab0c960","widget":"hello_world.t27 to Rust, in a terminal inside the post","height":480}]},{"n":5,"title":{"en":"From spec to hardware","ru":"От спеки к железу"},"lessons":[{"id":"spec-to-verilog","n":13,"title":{"en":"From a spec to Verilog","ru":"От спеки к Verilog"},"goal":{"en":"How a t27 function becomes logic, and how a clocked function becomes registers.","ru":"Как функция t27 становится логикой, а тактируемая функция — регистрами."},"frame":"play/embed.html?spec=specs%2Fdemos%2Fhello_world.t27&cast=t27c-hello-world&tab=term&backend=verilog&v=7cbe9ab0c960","widget":"hello_world.t27 to Verilog, in a terminal inside the post","height":480},{"id":"count-the-cells","n":14,"title":{"en":"Count the cells","ru":"Посчитайте ячейки"},"goal":{"en":"How to count what a synthesizer built: LUTs, flip-flops, DSPs, block RAM.","ru":"Как посчитать, что построил синтезатор: LUT, триггеры, DSP, блочную память."},"frame":"widgets/stat-card/index.html?embed=1","widget":"Stat card: your yosys stat -json as a card and a README badge","height":640},{"id":"one-lut-up-close","n":15,"title":{"en":"One LUT, up close","ru":"Одна LUT вблизи"},"goal":{"en":"What a 6-input lookup table is, and how 64 bits describe any gate.","ru":"Что такое таблица истинности на 6 входов и как 64 бита описывают любой вентиль."},"frame":"widgets/lut-explain/index.html?embed=1","widget":"LUT explain: a 7-series LUT6 INIT and its FASM line, read as logic","height":640}]},{"n":6,"title":{"en":"Reading synthesis","ru":"Читаем синтез"},"lessons":[{"id":"synthesis-warnings","n":16,"title":{"en":"Synthesis warnings that matter","ru":"Важные предупреждения синтеза"},"goal":{"en":"How to read a yosys log, and the warnings that become bugs on silicon.","ru":"Как читать лог yosys и какие предупреждения становятся ошибками на кремнии."},"frame":"widgets/synth-smells/index.html?embed=1","widget":"Synth smells: a lint card for your yosys log","height":640},{"id":"state-machines","n":17,"title":{"en":"State machines","ru":"Конечные автоматы"},"goal":{"en":"How a synthesizer finds a state machine in your design, or refuses to.","ru":"Как синтезатор находит в дизайне конечный автомат — или отказывается."},"frame":"widgets/fsm-sketch/index.html?embed=1","widget":"FSM sketch: the state machine yosys found in your RTL","height":640},{"id":"where-the-luts-go","n":18,"title":{"en":"Where the LUTs go","ru":"Куда уходят LUT"},"goal":{"en":"Which part of a design spends the LUTs, and why hierarchy matters.","ru":"Какая часть дизайна тратит LUT и почему важна иерархия."},"frame":"widgets/lut-treemap/index.html?embed=1","widget":"LUT treemap: which submodule eats your LUTs, from yosys stat -json","height":640}]},{"n":7,"title":{"en":"Place, route, timing","ru":"Размещение, трассировка, тайминг"},"lessons":[{"id":"placement","n":19,"title":{"en":"Placement: where the cells land","ru":"Размещение: где оказываются ячейки"},"goal":{"en":"What place and route does, and where it put a real design.","ru":"Что делают размещение и трассировка и куда они поставили настоящий дизайн."},"frame":"widgets/placement-map/index.html?embed=1","widget":"Placement map: where nextpnr put every cell on the XC7A200T","height":640},{"id":"logic-depth","n":20,"title":{"en":"Logic depth","ru":"Глубина логики"},"goal":{"en":"Why the longest chain of logic sets how fast a design can run.","ru":"Почему самая длинная цепочка логики задаёт, насколько быстро может работать дизайн."},"frame":"widgets/lut-depth/index.html?embed=1","widget":"LUT depth: your longest yosys path, drawn as a staircase","height":640},{"id":"timing-slack","n":21,"title":{"en":"Timing and slack","ru":"Тайминг и запас"},"goal":{"en":"What slack is, and how to read a timing report path by path.","ru":"Что такое slack и как читать отчёт о тайминге путь за путём."},"frame":"widgets/slack-waterfall/index.html?embed=1","widget":"Slack waterfall: every timing path of a routed design, worst first","height":640}]},{"n":8,"title":{"en":"The bitstream","ru":"Битстрим"},"lessons":[{"id":"fasm-to-frames","n":22,"title":{"en":"From FASM to frames","ru":"От FASM к фреймам"},"goal":{"en":"What FASM is, and how features become configuration frames.","ru":"Что такое FASM и как фичи становятся конфигурационными фреймами."},"frame":"term/tri-x7-fasm/index.html","widget":"tri x7-fasm · a bitstream assembled without Vivado","height":640},{"id":"a-build-receipt","n":23,"title":{"en":"A build, itemised","ru":"Сборка по пунктам"},"goal":{"en":"Every stage from a spec to a bitstream, with its time, tool and hash.","ru":"Каждая стадия от спеки до битстрима — с временем, инструментом и хешем."},"frame":"widgets/build-receipt/index.html?embed=1","widget":"Build receipt: t27 spec to XC7A200T bitstream, no Vivado","height":640},{"id":"read-a-bitstream","n":24,"title":{"en":"Read a bitstream","ru":"Читаем битстрим"},"goal":{"en":"What is inside a .bit file, and which chip it was built for.","ru":"Что внутри файла .bit и для какого чипа он собран."},"frame":"widgets/bit-autopsy/index.html?embed=1","widget":"Bitstream autopsy: which FPGA a 7-series .bit really targets","height":640}]},{"n":9,"title":{"en":"On the board","ru":"На плате"},"lessons":[{"id":"jtag-asks-the-chip","n":25,"title":{"en":"JTAG asks the chip","ru":"JTAG спрашивает чип"},"goal":{"en":"How a cable finds the chip on a board and reads its IDCODE.","ru":"Как кабель находит чип на плате и читает его IDCODE."},"frame":"term/tri-fpga-jtag/index.html","widget":"tri fpga-jtag · which chip answered the cable","height":640},{"id":"same-bits-on-the-board","n":26,"title":{"en":"The same bits, on the board","ru":"Те же биты — на плате"},"goal":{"en":"How to show that a bitstream is byte-identical and that it runs.","ru":"Как показать, что битстрим совпадает байт в байт и что он работает."},"frame":"term/x7-board/index.html","widget":"A bitstream from t27 specs, run on the AX7203","height":640},{"id":"capstone","n":27,"title":{"en":"Capstone: out-guess yosys","ru":"Итог: переугадайте yosys"},"goal":{"en":"Put it together: guess what a real t27 module costs in LUTs.","ru":"Соберите всё вместе: угадайте, сколько LUT стоит настоящий модуль t27."},"frame":"widgets/gatle/index.html?embed=1","widget":"Gatle: guess how many LUTs yosys spends on today's t27 module","height":640}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/goldenfloat.json b/apps/website/public/widgets/course-deck/courses/goldenfloat.json new file mode 100644 index 0000000000..b54972da79 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/goldenfloat.json @@ -0,0 +1 @@ +{"id":"goldenfloat","route":"goldenfloat","title":{"en":"GoldenFloat with t27: one rule, seventeen float widths","ru":"GoldenFloat на t27: одно правило, семнадцать ширин чисел"},"onePage":{"en":"/learn/goldenfloat/all/","ru":"/ru/learn/goldenfloat/all/"},"modules":[{"n":1,"title":{"en":"The rule and its numbers","ru":"Правило и его числа"},"lessons":[{"id":"a-float-cut-by-phi","n":1,"title":{"en":"A float cut by phi","ru":"Число с плавающей точкой, разрезанное по phi"},"goal":{"en":"How one rule, E = round((N - 1) / phi^2), splits every GoldenFloat width into sign, exponent and mantissa.","ru":"Как одно правило, E = round((N - 1) / phi^2), делит каждую ширину GoldenFloat на знак, порядок и мантиссу."},"frame":"widgets/golden-split/index.html?embed=1","widget":"GoldenFloat 1: one rule for every width","height":640},{"id":"phi-as-a-ratio","n":2,"title":{"en":"Phi as a ratio","ru":"Phi как отношение"},"goal":{"en":"How phi_ratio.t27 computes a split for any width, and why the distance from 1 / phi does not shrink at every step.","ru":"Как phi_ratio.t27 считает деление для любой ширины и почему расстояние до 1 / phi уменьшается не на каждом шаге."},"frame":"widgets/golden-phi-ratio/index.html?embed=1","widget":"GoldenFloat 2: phi as a ratio","height":640},{"id":"lucas-numbers-stay-whole","n":3,"title":{"en":"Lucas numbers stay whole","ru":"Числа Люка остаются целыми"},"goal":{"en":"Why phi^(2n) + phi^(-2n) is always a whole number, and where the 3 of phi^2 + 1/phi^2 = 3 comes from.","ru":"Почему phi^(2n) + phi^(-2n) всегда целое число и откуда берётся 3 в phi^2 + 1/phi^2 = 3."},"frame":"widgets/golden-lucas/index.html?embed=1","widget":"GoldenFloat 3: Lucas numbers stay whole","height":640}]},{"n":2,"title":{"en":"Why phi, why three","ru":"Почему phi, почему три"},"lessons":[{"id":"why-the-split-is-phi","n":4,"title":{"en":"Why the split is phi","ru":"Почему деление по phi"},"goal":{"en":"Two arguments for the phi split, and why the spec says the self-similarity one is not an optimisation.","ru":"Два довода за деление по phi и почему спека говорит, что довод о самоподобии — не оптимизация."},"frame":"widgets/golden-split-optimality/index.html?embed=1","widget":"GoldenFloat 4: why the split is phi","height":640},{"id":"why-base-three","n":5,"title":{"en":"Why base three","ru":"Почему основание три"},"goal":{"en":"Why ln(b) / b peaks at e, how close base 3 comes, and what 27 trits are worth in bits.","ru":"Почему ln(b) / b достигает пика в e, насколько близко подходит основание 3 и сколько битов стоят 27 тритов."},"frame":"widgets/golden-radix-economy/index.html?embed=1","widget":"GoldenFloat 5: why base three","height":640},{"id":"phi-in-sixteen-bits","n":6,"title":{"en":"Phi in sixteen bits","ru":"Phi в шестнадцати битах"},"goal":{"en":"How a spec checks that GF16 keeps phi, phi^2 = phi + 1 and phi^2 + 1/phi^2 = 3 within a stated tolerance.","ru":"Как спека проверяет, что GF16 сохраняет phi, phi^2 = phi + 1 и phi^2 + 1/phi^2 = 3 с заявленным допуском."},"frame":"widgets/golden-phi-in-gf16/index.html?embed=1","widget":"GoldenFloat 6: phi in sixteen bits","height":640}]},{"n":3,"title":{"en":"The small rungs: GF4 to GF8","ru":"Малые ступени: от GF4 до GF8"},"lessons":[{"id":"gf4-four-bits","n":7,"title":{"en":"GF4: four bits","ru":"GF4: четыре бита"},"goal":{"en":"The smallest GoldenFloat: one sign bit, one exponent bit, two mantissa bits, bias 0.","ru":"Самый маленький GoldenFloat: один бит знака, один бит порядка, два бита мантиссы, смещение 0."},"frame":"widgets/golden-gf4/index.html?embed=1","widget":"GoldenFloat 7: GF4, four bits","height":640},{"id":"gf6-six-bits","n":8,"title":{"en":"GF6: six bits","ru":"GF6: шесть битов"},"goal":{"en":"How the rule splits 6 bits into 1 + 2 + 3, and what bias 1 means.","ru":"Как правило делит 6 битов на 1 + 2 + 3 и что значит смещение 1."},"frame":"widgets/golden-gf6/index.html?embed=1","widget":"GoldenFloat 8: GF6, six bits","height":640},{"id":"gf8-one-byte","n":9,"title":{"en":"GF8: one byte","ru":"GF8: один байт"},"goal":{"en":"The one-byte GoldenFloat, 1 + 3 + 4, bias 3, and what its largest and smallest values are.","ru":"GoldenFloat в один байт, 1 + 3 + 4, смещение 3, и каковы его наибольшее и наименьшее значения."},"frame":"widgets/golden-gf8/index.html?embed=1","widget":"GoldenFloat 9: GF8, one byte","height":640}]},{"n":4,"title":{"en":"Ten to fourteen bits","ru":"От десяти до четырнадцати битов"},"lessons":[{"id":"gf10-ten-bits","n":10,"title":{"en":"GF10: ten bits","ru":"GF10: десять битов"},"goal":{"en":"How 10 bits split into 1 + 3 + 6, and why its ratio sits 0.118 from 1 / phi.","ru":"Как 10 битов делятся на 1 + 3 + 6 и почему его отношение стоит в 0.118 от 1 / phi."},"frame":"widgets/golden-gf10/index.html?embed=1","widget":"GoldenFloat 10: GF10, ten bits","height":640},{"id":"gf12-twelve-bits","n":11,"title":{"en":"GF12: twelve bits","ru":"GF12: двенадцать битов"},"goal":{"en":"The twelve-bit GoldenFloat, 1 + 4 + 7, bias 7, and how a test name can promise more than its assert.","ru":"GoldenFloat в двенадцать битов, 1 + 4 + 7, смещение 7, и как имя теста может обещать больше, чем его проверка."},"frame":"widgets/golden-gf12/index.html?embed=1","widget":"GoldenFloat 11: GF12, twelve bits","height":640},{"id":"gf14-fourteen-bits","n":12,"title":{"en":"GF14: fourteen bits","ru":"GF14: четырнадцать битов"},"goal":{"en":"How 14 bits split into 1 + 5 + 8, a ratio 0.007 from 1 / phi.","ru":"Как 14 битов делятся на 1 + 5 + 8, отношение в 0.007 от 1 / phi."},"frame":"widgets/golden-gf14/index.html?embed=1","widget":"GoldenFloat 12: GF14, fourteen bits","height":640}]},{"n":5,"title":{"en":"GF16 at work","ru":"GF16 в работе"},"lessons":[{"id":"gf16-the-primary","n":13,"title":{"en":"GF16: the primary format","ru":"GF16: основной формат"},"goal":{"en":"The 16-bit GoldenFloat the family marks primary: 1 + 6 + 9, bias 31, and its special codes.","ru":"GoldenFloat на 16 битов, который семейство отмечает основным: 1 + 6 + 9, смещение 31 и его особые коды."},"frame":"widgets/golden-gf16/index.html?embed=1","widget":"GoldenFloat 13: GF16, the primary format","height":640},{"id":"two-products-one-sum","n":14,"title":{"en":"Two products, one sum","ru":"Два произведения, одна сумма"},"goal":{"en":"How a GF-T16 multiply-accumulate computes a1 * b1 + a2 * b2, the kernel of a matrix multiply.","ru":"Как умножение с накоплением в GF-T16 считает a1 * b1 + a2 * b2, ядро умножения матриц."},"frame":"widgets/golden-dot-two/index.html?embed=1","widget":"GoldenFloat 14: two products, one sum","height":640},{"id":"gf24-twenty-four-bits","n":15,"title":{"en":"GF20 and GF24","ru":"GF20 и GF24"},"goal":{"en":"The 20- and 24-bit GoldenFloats, 1 + 7 + 12 and 1 + 9 + 14, and the tolerance each spec allows.","ru":"GoldenFloat в 20 и 24 бита, 1 + 7 + 12 и 1 + 9 + 14, и допуск, который даёт каждая спека."},"frame":"widgets/golden-gf24/index.html?embed=1","widget":"GoldenFloat 15: GF20 and GF24","height":640}]},{"n":6,"title":{"en":"GF32 to GF64","ru":"От GF32 до GF64"},"lessons":[{"id":"gf32-a-single","n":16,"title":{"en":"GF32: a single","ru":"GF32: одинарная точность"},"goal":{"en":"The 32-bit GoldenFloat, 1 + 12 + 19, bias 2047, and the two invariants that compare it with IEEE single.","ru":"GoldenFloat в 32 бита, 1 + 12 + 19, смещение 2047, и два инварианта, которые сравнивают его с IEEE single."},"frame":"widgets/golden-gf32/index.html?embed=1","widget":"GoldenFloat 16: GF32, a single","height":640},{"id":"gf48-forty-eight-bits","n":17,"title":{"en":"GF48: forty-eight bits","ru":"GF48: сорок восемь битов"},"goal":{"en":"How the rule splits 48 bits into 1 + 18 + 29, a width IEEE 754 does not have.","ru":"Как правило делит 48 битов на 1 + 18 + 29, ширину, которой нет в IEEE 754."},"frame":"widgets/golden-gf48/index.html?embed=1","widget":"GoldenFloat 17: GF48, forty-eight bits","height":640},{"id":"gf64-a-double","n":18,"title":{"en":"GF64: a double","ru":"GF64: двойная точность"},"goal":{"en":"The 64-bit GoldenFloat, 1 + 24 + 39, beside IEEE double, and how its encoder clamps the exponent.","ru":"64-битный GoldenFloat, 1 + 24 + 39, рядом с двойной точностью IEEE, и как его кодировщик ограничивает порядок."},"frame":"widgets/golden-gf64/index.html?embed=1","widget":"GoldenFloat 18: GF64, a double","height":640}]},{"n":7,"title":{"en":"GF96 to GF256","ru":"От GF96 до GF256"},"lessons":[{"id":"gf96-ninety-six-bits","n":19,"title":{"en":"GF96: ninety-six bits","ru":"GF96: девяносто шесть битов"},"goal":{"en":"Why the spec of a 96-bit float writes its bias as an expression, not a number.","ru":"Почему спека 96-битного числа записывает смещение выражением, а не числом."},"frame":"widgets/golden-gf96/index.html?embed=1","widget":"GoldenFloat 19: GF96, ninety-six bits","height":640},{"id":"gf128-a-quad","n":20,"title":{"en":"GF128: a quad","ru":"GF128: четверная точность"},"goal":{"en":"The 128-bit GoldenFloat, 1 + 49 + 78, and the four invariants that hold its layout.","ru":"128-битный GoldenFloat, 1 + 49 + 78, и четыре инварианта, которые держат его раскладку."},"frame":"widgets/golden-gf128/index.html?embed=1","widget":"GoldenFloat 20: GF128, a quad","height":640},{"id":"gf256-two-five-six","n":21,"title":{"en":"GF256: two hundred fifty-six bits","ru":"GF256: двести пятьдесят шесть битов"},"goal":{"en":"How the rule splits 256 bits into 1 + 97 + 158.","ru":"Как правило делит 256 битов на 1 + 97 + 158."},"frame":"widgets/golden-gf256/index.html?embed=1","widget":"GoldenFloat 21: GF256","height":640}]},{"n":8,"title":{"en":"The widest rungs, then trits","ru":"Самые широкие ступени, затем триты"},"lessons":[{"id":"gf512-five-twelve","n":22,"title":{"en":"GF512: five hundred twelve bits","ru":"GF512: пятьсот двенадцать битов"},"goal":{"en":"How the rule splits 512 bits into 1 + 195 + 316, a ratio within 0.001 of 1 / phi.","ru":"Как правило делит 512 битов на 1 + 195 + 316, отношение в пределах 0.001 от 1 / phi."},"frame":"widgets/golden-gf512/index.html?embed=1","widget":"GoldenFloat 22: GF512","height":640},{"id":"gf1024-one-kilobit","n":23,"title":{"en":"GF1024: one kilobit","ru":"GF1024: один килобит"},"goal":{"en":"The widest rung of the family, 1 + 391 + 632, and the test that names it.","ru":"Самая широкая ступень семейства, 1 + 391 + 632, и тест, который её называет."},"frame":"widgets/golden-gf1024/index.html?embed=1","widget":"GoldenFloat 23: GF1024, one kilobit","height":640},{"id":"gft8-exponent-in-trits","n":24,"title":{"en":"GF-T8: an exponent in trits","ru":"GF-T8: порядок в тритах"},"goal":{"en":"How GF-T keeps the phi split but stores the exponent in balanced trits: 1 + 3 trits + 4 bits.","ru":"Как GF-T сохраняет деление по phi, но хранит порядок в сбалансированных тритах: 1 + 3 трита + 4 бита."},"frame":"widgets/golden-gft8/index.html?embed=1","widget":"GoldenFloat 24: GF-T8, an exponent in trits","height":640}]},{"n":9,"title":{"en":"More trits, then the decode","ru":"Ещё триты, затем декодирование"},"lessons":[{"id":"gft16-six-trits","n":25,"title":{"en":"GF-T16: six trits","ru":"GF-T16: шесть тритов"},"goal":{"en":"How GF-T16 spends 6 exponent trits and 9 mantissa bits, and how many exponent values that gives.","ru":"Как GF-T16 тратит 6 тритов порядка и 9 битов мантиссы и сколько значений порядка это даёт."},"frame":"widgets/golden-gft16/index.html?embed=1","widget":"GoldenFloat 25: GF-T16, six trits","height":640},{"id":"gft32-twelve-trits","n":26,"title":{"en":"GF-T32: twelve trits","ru":"GF-T32: двенадцать тритов"},"goal":{"en":"How GF-T32 spends 12 exponent trits and 19 mantissa bits.","ru":"Как GF-T32 тратит 12 тритов порядка и 19 битов мантиссы."},"frame":"widgets/golden-gft32/index.html?embed=1","widget":"GoldenFloat 26: GF-T32, twelve trits","height":640},{"id":"decode-in-one-step","n":27,"title":{"en":"Decode in one step","ru":"Раскодировать за один шаг"},"goal":{"en":"Why a fixed-field format decodes its fields in parallel and a posit cannot, as the spec counts the steps.","ru":"Почему формат с полями фиксированной длины раскодирует поля параллельно, а позит не может, как спека считает шаги."},"frame":"widgets/golden-decode/index.html?embed=1","widget":"GoldenFloat 27: decode in one step","height":640}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/index.json b/apps/website/public/widgets/course-deck/courses/index.json new file mode 100644 index 0000000000..91a51c49ec --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/index.json @@ -0,0 +1 @@ +[{"id":"t27-basics","title":{"en":"t27 basics: the language in 27 lessons","ru":"Основы t27: язык за 27 уроков"}},{"id":"course","title":{"en":"From zero to a chip: FPGA programming with t27","ru":"С нуля до чипа: программирование FPGA на t27"}},{"id":"ai-numbers","title":{"en":"AI numbers with t27: from number formats to a ternary network","ru":"ИИ-числа на t27: от форматов чисел до тернарной сети"}},{"id":"goldenfloat","title":{"en":"GoldenFloat with t27: one rule, seventeen float widths","ru":"GoldenFloat на t27: одно правило, семнадцать ширин чисел"}},{"id":"verify-hardware","title":{"en":"Verifying hardware with t27: testbenches, waveforms, formal, mutation","ru":"Проверка железа с t27: тестбенчи, временные диаграммы, формальные методы, мутации"}},{"id":"clocks-and-cdc","title":{"en":"Clocking, resets and clock-domain crossings with t27","ru":"Тактирование, сброс и пересечения тактовых доменов на t27"}},{"id":"buses-and-peripherals","title":{"en":"Buses and peripherals with t27: UART, SPI, APB, AXI4, Ethernet","ru":"Шины и периферия на t27: UART, SPI, APB, AXI4, Ethernet"}},{"id":"ternary-computing","title":{"en":"The ternary machine: from a trit to a running program","ru":"Троичная машина: от трита до работающей программы"}},{"id":"arithmetic-and-dsp","title":{"en":"Arithmetic and DSP on the FPGA: from the carry chain to a filter","ru":"Арифметика и DSP на FPGA: от цепи переноса до фильтра"}},{"id":"neural-networks","title":{"en":"Neural networks in t27: from one neuron to a transformer block","ru":"Нейросети на t27: от одного нейрона до блока трансформера"}},{"id":"queen-and-hive","title":{"en":"The Queen and the hive: how the t27 project builds itself","ru":"Королева и улей: как проект t27 строит себя сам"}}] diff --git a/apps/website/public/widgets/course-deck/courses/neural-networks.json b/apps/website/public/widgets/course-deck/courses/neural-networks.json new file mode 100644 index 0000000000..844ff7d204 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/neural-networks.json @@ -0,0 +1 @@ +{"id":"neural-networks","route":"neural-networks","title":{"en":"Neural networks in t27: from one neuron to a transformer block","ru":"Нейросети на t27: от одного нейрона до блока трансформера"},"onePage":{"en":"/learn/neural-networks/all/","ru":"/ru/learn/neural-networks/all/"},"modules":[{"n":1,"title":{"en":"One neuron","ru":"Один нейрон"},"lessons":[{"id":"relu","n":1,"title":{"en":"ReLU: keep the positive part","ru":"ReLU: оставить положительную часть"},"goal":{"en":"What ReLU does to a positive and to a negative input, and why a slope of 0 stops a unit from learning.","ru":"Что ReLU делает с положительным и с отрицательным входом и почему наклон 0 останавливает обучение нейрона."},"frame":"widgets/nn-relu/index.html?embed=1","widget":"ReLU: what a neuron does with a negative number","height":760},{"id":"the-sigmoid","n":2,"title":{"en":"The sigmoid: a number into a probability","ru":"Сигмоида: число в вероятность"},"goal":{"en":"How the sigmoid maps any input to a probability, and why its slope limits deep networks.","ru":"Как сигмоида переводит любой вход в вероятность и почему её наклон мешает глубоким сетям."},"frame":"widgets/nn-sigmoid/index.html?embed=1","widget":"Sigmoid: turn any number into a probability","height":760},{"id":"tanh-and-saturation","n":3,"title":{"en":"tanh and saturation","ru":"tanh и насыщение"},"goal":{"en":"Why tanh is centred on zero, and where its slope falls so low that a unit stops learning.","ru":"Почему tanh центрирована на нуле и где её наклон падает так низко, что нейрон перестаёт учиться."},"frame":"widgets/nn-tanh/index.html?embed=1","widget":"tanh: where a neuron stops learning","height":760}]},{"n":2,"title":{"en":"New bends","ru":"Новые изгибы"},"lessons":[{"id":"gelu","n":4,"title":{"en":"GELU: a dip below zero","ru":"GELU: провал ниже нуля"},"goal":{"en":"What GELU computes, why it dips below zero, and how close its tanh shortcut comes.","ru":"Что вычисляет GELU, почему она проваливается ниже нуля и насколько близко подходит её приближение через tanh."},"frame":"widgets/nn-gelu/index.html?embed=1","widget":"GELU: why transformers bend a little below zero","height":760},{"id":"swish-and-silu","n":5,"title":{"en":"Swish and SiLU","ru":"Swish и SiLU"},"goal":{"en":"How x times sigmoid(beta x) gates itself, and how one parameter moves it from a smooth curve to ReLU.","ru":"Как x, умноженный на sigmoid(beta x), открывает сам себя и как один параметр переводит его от гладкой кривой к ReLU."},"frame":"widgets/nn-silu/index.html?embed=1","widget":"Swish: one knob between a smooth curve and ReLU","height":760},{"id":"elu","n":6,"title":{"en":"ELU: a floor, not a cliff","ru":"ELU: пол, а не обрыв"},"goal":{"en":"How ELU keeps a soft negative side with a floor at -alpha, and why its slope never quite dies.","ru":"Как ELU сохраняет мягкую отрицательную сторону с полом на -alpha и почему её наклон никогда не умирает до конца."},"frame":"widgets/nn-elu/index.html?embed=1","widget":"ELU: a negative side with a floor","height":760}]},{"n":3,"title":{"en":"A layer","ru":"Слой"},"lessons":[{"id":"softmax-and-temperature","n":7,"title":{"en":"Softmax and temperature","ru":"Softmax и температура"},"goal":{"en":"How softmax turns scores into probabilities that sum to one, and what the temperature does to them.","ru":"Как softmax превращает оценки в вероятности с суммой один и что с ними делает температура."},"frame":"widgets/nn-softmax/index.html?embed=1","widget":"Softmax: how a network turns scores into a choice","height":760},{"id":"embeddings","n":8,"title":{"en":"Embeddings","ru":"Эмбеддинги"},"goal":{"en":"How a token becomes a row of numbers, and why learning changes only the rows that were read.","ru":"Как токен превращается в строку чисел и почему обучение меняет только прочитанные строки."},"frame":"widgets/nn-embedding/index.html?embed=1","widget":"Embeddings: how a word becomes a row of numbers","height":760},{"id":"dropout","n":9,"title":{"en":"Dropout","ru":"Dropout: выключенные нейроны"},"goal":{"en":"Why switching units off while training helps, and why the survivors must be scaled.","ru":"Почему выключение нейронов во время обучения помогает и почему выживших нужно масштабировать."},"frame":"widgets/nn-dropout/index.html?embed=1","widget":"Dropout: training a network with neurons switched off","height":760}]},{"n":4,"title":{"en":"Pictures","ru":"Картинки"},"lessons":[{"id":"patches-of-a-picture","n":10,"title":{"en":"Patches of a picture","ru":"Участки картинки"},"goal":{"en":"Why networks read a picture in patches, and what a 2 x 2 window averaged over each patch gives.","ru":"Почему сети читают картинку по участкам и что даёт окно 2 x 2, усреднённое по каждому участку."},"frame":"widgets/nn-conv/index.html?embed=1","widget":"Patches of a picture: a 2 x 2 window, averaged","height":760},{"id":"max-pooling","n":11,"title":{"en":"Max pooling","ru":"Max pooling: максимум окна"},"goal":{"en":"What max pooling keeps, where it remembers taking it from, and where the gradient goes.","ru":"Что оставляет max pooling, откуда, как он помнит, это взято и куда идёт градиент."},"frame":"widgets/nn-maxpool/index.html?embed=1","widget":"Max pooling: what a network keeps when it shrinks a picture","height":760},{"id":"batch-normalisation","n":12,"title":{"en":"Batch normalisation","ru":"Пакетная нормализация"},"goal":{"en":"How batch norm puts features on different scales on one scale, and what it uses at inference.","ru":"Как пакетная нормализация приводит признаки разного масштаба к одному и чем она пользуется при выводе."},"frame":"widgets/nn-batchnorm/index.html?embed=1","widget":"Batch norm: features on very different scales, made comparable","height":760}]},{"n":5,"title":{"en":"The error","ru":"Ошибка"},"lessons":[{"id":"mean-squared-error","n":13,"title":{"en":"Mean squared error","ru":"Среднеквадратичная ошибка"},"goal":{"en":"How MSE turns every miss into one number, why it chases large errors, and where its gradient points.","ru":"Как MSE превращает каждый промах в одно число, почему она гоняется за большими ошибками и куда смотрит её градиент."},"frame":"widgets/nn-mse/index.html?embed=1","widget":"Mean squared error: how wrong a guess is, as one number","height":760},{"id":"cross-entropy","n":14,"title":{"en":"Cross-entropy","ru":"Перекрёстная энтропия"},"goal":{"en":"Why cross-entropy charges a confident wrong answer so much, and why that is what trains a classifier.","ru":"Почему перекрёстная энтропия так дорого берёт за уверенный неверный ответ и почему именно это учит классификатор."},"frame":"widgets/nn-bce/index.html?embed=1","widget":"Cross-entropy: why a confident wrong answer costs so much","height":760},{"id":"the-huber-loss","n":15,"title":{"en":"The Huber loss","ru":"Функция Хьюбера"},"goal":{"en":"How the Huber loss treats a small error like squared error and a large one linearly, so outliers pull less.","ru":"Как функция Хьюбера обходится с малой ошибкой как с квадратичной, а с большой линейно, чтобы выбросы тянули слабее."},"frame":"widgets/nn-huber/index.html?embed=1","widget":"Huber loss: a loss that does not panic at an outlier","height":760}]},{"n":6,"title":{"en":"Downhill","ru":"Под гору"},"lessons":[{"id":"gradient-descent","n":16,"title":{"en":"Gradient descent","ru":"Градиентный спуск"},"goal":{"en":"How gradient descent walks down a loss, what momentum adds, and why too large a rate never settles.","ru":"Как градиентный спуск идёт вниз по функции потерь, что добавляет момент и почему слишком большой шаг никогда не успокаивается."},"frame":"widgets/nn-sgd/index.html?embed=1","widget":"Gradient descent: how a network walks downhill","height":760},{"id":"rmsprop","n":17,"title":{"en":"RMSProp","ru":"RMSProp: шаг без масштаба"},"goal":{"en":"How RMSProp divides each step by a running root mean square, so the step no longer depends on the gradient's size.","ru":"Как RMSProp делит каждый шаг на скользящий корень среднего квадрата, чтобы шаг больше не зависел от величины градиента."},"frame":"widgets/nn-rmsprop/index.html?embed=1","widget":"RMSProp: a step that does not care how big the gradient is","height":760},{"id":"adam","n":18,"title":{"en":"Adam","ru":"Adam: момент и масштаб"},"goal":{"en":"How Adam combines momentum with a running scale, and why its bias correction makes step 1 a fixed size.","ru":"Как Adam соединяет момент со скользящим масштабом и почему поправка смещения делает шаг 1 фиксированного размера."},"frame":"widgets/nn-adam/index.html?embed=1","widget":"Adam: the optimizer most networks are trained with","height":760}]},{"n":7,"title":{"en":"Learning","ru":"Обучение"},"lessons":[{"id":"backpropagation","n":19,"title":{"en":"Backpropagation","ru":"Обратное распространение"},"goal":{"en":"How the gradient of each weight and each input of a layer follows from the gradient of its outputs.","ru":"Как градиент каждого веса и каждого входа слоя следует из градиента его выходов."},"frame":"widgets/nn-backprop/index.html?embed=1","widget":"Backpropagation: how blame flows back through a layer","height":760},{"id":"learning-xor","n":20,"title":{"en":"Learning XOR","ru":"Учим XOR"},"goal":{"en":"Why one neuron cannot learn XOR, and how a hidden layer trained by backpropagation does.","ru":"Почему один нейрон не может выучить XOR и как это делает скрытый слой, обученный обратным распространением."},"frame":"widgets/nn-xor/index.html?embed=1","widget":"XOR: a network learns what one neuron cannot","height":760},{"id":"lamb-and-large-batches","n":21,"title":{"en":"LAMB and large batches","ru":"LAMB и большие пакеты"},"goal":{"en":"How LAMB scales each layer's step by its own weight norm, so one learning rate suits layers of every size.","ru":"Как LAMB масштабирует шаг каждого слоя его собственной нормой весов, чтобы один шаг обучения подходил слоям любого размера."},"frame":"widgets/nn-lamb/index.html?embed=1","widget":"LAMB: one learning rate for layers of every size","height":760}]},{"n":8,"title":{"en":"Memory and attention","ru":"Память и внимание"},"lessons":[{"id":"a-recurrent-cell","n":22,"title":{"en":"A recurrent cell","ru":"Рекуррентная ячейка"},"goal":{"en":"How a recurrent cell carries a state from step to step, and why that memory fades.","ru":"Как рекуррентная ячейка переносит состояние от шага к шагу и почему эта память затухает."},"frame":"widgets/nn-rnn/index.html?embed=1","widget":"Recurrent cells: how a network remembers a moment ago","height":760},{"id":"lstm-gates","n":23,"title":{"en":"LSTM gates","ru":"Вентили LSTM"},"goal":{"en":"How the forget, input and output gates of an LSTM decide what the cell keeps, writes and shows.","ru":"Как вентили забывания, входа и выхода LSTM решают, что ячейка хранит, записывает и показывает."},"frame":"widgets/nn-lstm/index.html?embed=1","widget":"LSTM gates: how a cell decides what to keep","height":760},{"id":"attention","n":24,"title":{"en":"Attention","ru":"Внимание"},"goal":{"en":"How attention scores every query against every key, what a softmax over each row gives, and what the causal mask removes.","ru":"Как внимание сравнивает каждый запрос с каждым ключом, что даёт softmax по каждой строке и что убирает причинная маска."},"frame":"widgets/nn-attention/index.html?embed=1","widget":"Attention: how a word decides which other words to read","height":760}]},{"n":9,"title":{"en":"The transformer and the reward","ru":"Трансформер и награда"},"lessons":[{"id":"positional-encoding","n":25,"title":{"en":"Positional encoding","ru":"Позиционное кодирование"},"goal":{"en":"How sines and cosines at falling frequencies give every position its own vector, and why a shift is a turn.","ru":"Как синусы и косинусы убывающих частот дают каждой позиции свой вектор и почему сдвиг это поворот."},"frame":"widgets/nn-positions/index.html?embed=1","widget":"Positional encoding: how a transformer knows word order","height":760},{"id":"an-encoder-block","n":26,"title":{"en":"An encoder block","ru":"Блок энкодера"},"goal":{"en":"What one transformer encoder block does to its input, and what moving the norms in front changes.","ru":"Что один блок энкодера трансформера делает со своим входом и что меняет перенос нормализаций вперёд."},"frame":"widgets/nn-encoder/index.html?embed=1","widget":"An encoder block: what one transformer layer does","height":760},{"id":"ppo-and-the-reward","n":27,"title":{"en":"PPO and the reward","ru":"PPO и награда"},"goal":{"en":"How PPO turns a reward into a policy update, and how its clip keeps one update from going too far.","ru":"Как PPO превращает награду в обновление политики и как его обрезка не даёт одному обновлению зайти слишком далеко."},"frame":"widgets/nn-ppo/index.html?embed=1","widget":"PPO: how an agent learns from reward without lurching","height":760}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/queen-and-hive.json b/apps/website/public/widgets/course-deck/courses/queen-and-hive.json new file mode 100644 index 0000000000..00fd639eaf --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/queen-and-hive.json @@ -0,0 +1 @@ +{"id":"queen-and-hive","route":"queen-and-hive","title":{"en":"The Queen and the hive: how the t27 project builds itself","ru":"Королева и улей: как проект t27 строит себя сам"},"onePage":{"en":"/learn/queen-and-hive/all/","ru":"/ru/learn/queen-and-hive/all/"},"modules":[{"n":1,"title":{"en":"The task","ru":"Задача"},"lessons":[{"id":"shaping-an-issue","n":1,"title":{"en":"Shaping an issue","ru":"Оформление задачи"},"goal":{"en":"What the Queen does with an issue that lacks sections, and why she stops after two tries.","ru":"Что Королева делает с задачей без нужных разделов и почему останавливается после двух попыток."},"frame":"widgets/hive-shape/index.html?embed=1","widget":"Shaping: what the Queen does with an issue that is not ready","height":760},{"id":"a-boundary-of-real-files","n":2,"title":{"en":"A boundary of real files","ru":"Граница из настоящих файлов"},"goal":{"en":"Which proposed paths a task may reserve, and why one invented path stops the whole shape.","ru":"Какие предложенные пути задача может забронировать и почему один выдуманный путь останавливает всё оформление."},"frame":"widgets/hive-boundary/index.html?embed=1","widget":"A boundary: which files a task may reserve","height":760},{"id":"one-task-three-kinds","n":3,"title":{"en":"One task, three kinds","ru":"Одна задача, три вида"},"goal":{"en":"How an issue, a review and a job become one kind of task with seven states, and how one filter reads them.","ru":"Как задача, ревью и фоновая работа становятся одним видом задачи с семью состояниями и как их читает один фильтр."},"frame":"widgets/hive-task-filter/index.html?embed=1","widget":"One task, three kinds: the filter the board and the game share","height":760}]},{"n":2,"title":{"en":"Who goes next","ru":"Кто следующий"},"lessons":[{"id":"aging-a-label","n":4,"title":{"en":"Aging a label","ru":"Старение метки"},"goal":{"en":"How a labelled issue moves up with age, and why only by one level.","ru":"Как задача с меткой поднимается с возрастом и почему только на один уровень."},"frame":"widgets/hive-aging/index.html?embed=1","widget":"Aging: how long a labelled low issue waits","height":760},{"id":"the-queue","n":5,"title":{"en":"The queue","ru":"Очередь"},"goal":{"en":"How the cap, aging and blockers order a queue of open issues.","ru":"Как потолок, старение и блокеры упорядочивают очередь открытых задач."},"frame":"widgets/hive-rank/index.html?embed=1","widget":"The queue: which issue the Queen takes first","height":760},{"id":"review-first","n":6,"title":{"en":"Review first","ru":"Сначала ревью"},"goal":{"en":"Why the Queen closes the backlog while finished work waits for a review, and what still goes.","ru":"Почему Королева закрывает бэклог, пока готовая работа ждёт ревью, и что всё равно идёт."},"frame":"widgets/hive-review-first/index.html?embed=1","widget":"Review first: no new work while finished work waits","height":760}]},{"n":3,"title":{"en":"A bee's life","ru":"Жизнь пчелы"},"lessons":[{"id":"a-tasks-life","n":7,"title":{"en":"A task's life","ru":"Жизнь задачи"},"goal":{"en":"Which states a dispatched task passes through, and which events are legal in each.","ru":"Через какие состояния проходит запущенная задача и какие события допустимы в каждом."},"frame":"widgets/hive-lifecycle/index.html?embed=1","widget":"A task's life: the Queen's state machine","height":760},{"id":"the-ship-flies-home","n":8,"title":{"en":"The ship flies home","ru":"Корабль летит домой"},"goal":{"en":"Where the game draws a bee for each thing it is doing, and how a finished task ends on screen.","ru":"Где игра рисует пчелу в каждом её занятии и как завершённая задача заканчивается на экране."},"frame":"widgets/hive-ship/index.html?embed=1","widget":"The game: where a bee flies and how it leaves","height":760},{"id":"a-deploy-mid-flight","n":9,"title":{"en":"A deploy mid-flight","ru":"Деплой на лету"},"goal":{"en":"What a redeploy does to a bee, a review, a round, a job and a wait.","ru":"Что передеплой делает с пчелой, ревью, раундом, фоновой работой и ожиданием."},"frame":"widgets/hive-drain/index.html?embed=1","widget":"A deploy mid-flight: what happens to a running bee","height":760}]},{"n":4,"title":{"en":"The reviewer bee","ru":"Пчела-ревьюер"},"lessons":[{"id":"enough-reviewers","n":10,"title":{"en":"Enough reviewers","ru":"Хватит ли ревьюеров"},"goal":{"en":"How many reviews must run at once for the reviewer to keep up with the bees.","ru":"Сколько ревью должно идти сразу, чтобы ревьюер успевал за пчёлами."},"frame":"widgets/hive-reviewers/index.html?embed=1","widget":"How many reviewer bees: keeping up with the finish rate","height":760},{"id":"back-off","n":11,"title":{"en":"Back off","ru":"Отступить"},"goal":{"en":"Why a row that answers wait is visited less and less often, and how often at least.","ru":"Почему строку, которая отвечает wait, проверяют всё реже и как часто хотя бы."},"frame":"widgets/hive-revisit/index.html?embed=1","widget":"Back off: when the reviewer looks at a waiting row again","height":760},{"id":"the-merge-gate","n":12,"title":{"en":"The merge gate","ru":"Ворота слияния"},"goal":{"en":"When the merger may merge a pull request a reviewer bee approved.","ru":"Когда мерджер может слить пулл-реквест, который одобрила пчела-ревьюер."},"frame":"widgets/hive-gate/index.html?embed=1","widget":"The merge gate: when an approved pull request may merge","height":760}]},{"n":5,"title":{"en":"The review jam","ru":"Затор ревью"},"lessons":[{"id":"the-review-jam","n":13,"title":{"en":"The review jam","ru":"Затор ревью"},"goal":{"en":"Which of ten cases a stuck pull request is in, and why the earliest matching rule wins.","ru":"В каком из десяти случаев застрявший пулл-реквест и почему побеждает правило, совпавшее раньше остальных."},"frame":"widgets/hive-jam/index.html?embed=1","widget":"The review jam: which case a stuck pull request is in","height":760},{"id":"the-queens-move","n":14,"title":{"en":"The Queen's move","ru":"Ход Королевы"},"goal":{"en":"What the Queen does for each jam, and which jams she waits on.","ru":"Что Королева делает в каждом заторе и каких заторов она ждёт."},"frame":"widgets/hive-jam-action/index.html?embed=1","widget":"The Queen's move: what each jam asks of her","height":760},{"id":"inherited-red","n":15,"title":{"en":"Inherited red","ru":"Унаследованный красный"},"goal":{"en":"When a red check on a pull request is inherited from master, and why a cancelled run says nothing.","ru":"Когда красная проверка пулл-реквеста унаследована от master и почему отменённый запуск ничего не говорит."},"frame":"widgets/hive-master-red/index.html?embed=1","widget":"Inherited red: what master's runs say about a red check","height":760}]},{"n":6,"title":{"en":"Keys","ru":"Ключи"},"lessons":[{"id":"a-refused-key","n":16,"title":{"en":"A refused key","ru":"Отклонённый ключ"},"goal":{"en":"How the Queen sorts a provider's refusal into transient, quota, auth or a bad request.","ru":"Как Королева сортирует отказ провайдера: временный, квота, доступ или неверный запрос."},"frame":"widgets/hive-key-error/index.html?embed=1","widget":"A refused key: transient, quota, auth or a bad request","height":760},{"id":"a-key-rests","n":17,"title":{"en":"A key rests","ru":"Ключ отдыхает"},"goal":{"en":"How long a refused key rests before a bee may use it again.","ru":"Сколько отклонённый ключ отдыхает, прежде чем пчела сможет взять его снова."},"frame":"widgets/hive-key-rest/index.html?embed=1","widget":"How long a refused key rests","height":760},{"id":"the-next-key","n":18,"title":{"en":"The next key","ru":"Следующий ключ"},"goal":{"en":"Which key a bee tries next, and when it moves to another pool or gives up.","ru":"Какой ключ пчела пробует следующим и когда переходит к другому пулу или сдаётся."},"frame":"widgets/hive-next-key/index.html?embed=1","widget":"The next key: a bee moves on instead of dying","height":760}]},{"n":7,"title":{"en":"Credit and money","ru":"Заслуги и деньги"},"lessons":[{"id":"no-credit-for-keys","n":19,"title":{"en":"No credit for keys","ru":"Ключи не дают заслуг"},"goal":{"en":"What a contributor's lent keys earn, and which limits keep them safe.","ru":"Что приносят ключи, которые одолжил участник, и какие пределы их берегут."},"frame":"widgets/hive-credit/index.html?embed=1","widget":"Lending a key earns no credit: XP follows recorded work","height":760},{"id":"twice-the-cost","n":20,"title":{"en":"Twice the cost","ru":"Вдвое дороже цены"},"goal":{"en":"How the project prices an operation and what a month of tokens buys.","ru":"Как проект назначает цену операции и что покупает месяц токенов."},"frame":"widgets/hive-price/index.html?embed=1","widget":"The price of an operation: twice its cost, rounded up","height":760},{"id":"tokens-that-burn","n":21,"title":{"en":"Tokens that burn","ru":"Сгорающие токены"},"goal":{"en":"When a batch of tokens burns, and which batch is spent first.","ru":"Когда сгорает партия токенов и какая партия тратится раньше."},"frame":"widgets/hive-burn/index.html?embed=1","widget":"Tokens that burn: a month to spend them","height":760}]},{"n":8,"title":{"en":"Agents among themselves","ru":"Агенты между собой"},"lessons":[{"id":"who-is-called","n":22,"title":{"en":"Who is called","ru":"Кого зовут"},"goal":{"en":"Which messages in the hive group wake an agent, from a person and from another agent's bot.","ru":"Какие сообщения в группе улья будят агента — от человека и от бота другого агента."},"frame":"widgets/hive-called/index.html?embed=1","widget":"Who is called: an agent bot in a group of agents","height":760},{"id":"three-bots-deep","n":23,"title":{"en":"Three bots deep","ru":"Три бота в глубину"},"goal":{"en":"How the hive stops agents from answering each other forever.","ru":"Как улей не даёт агентам отвечать друг другу бесконечно."},"frame":"widgets/hive-chain/index.html?embed=1","widget":"Chain depth: human, A, B, C, then silence","height":760},{"id":"stop-and-mute","n":24,"title":{"en":"Stop and mute","ru":"Stop и mute"},"goal":{"en":"What /stop and /mute do, and why neither can lose a person or a direct call.","ru":"Что делают /stop и /mute и почему ни один не теряет человека или прямой вызов."},"frame":"widgets/hive-cooldown/index.html?embed=1","widget":"The cooldown clock, /stop and /mute","height":760}]},{"n":9,"title":{"en":"Night and the board","ru":"Ночь и доска"},"lessons":[{"id":"the-night-watch","n":25,"title":{"en":"The night watch","ru":"Ночной дозор"},"goal":{"en":"What the night watch does in the morning with four card checks.","ru":"Что ночной дозор делает утром с четырьмя проверками карточек."},"frame":"widgets/hive-night/index.html?embed=1","widget":"The night watch: four checks, one verdict, one report","height":760},{"id":"the-public-board","n":26,"title":{"en":"The public board","ru":"Публичная доска"},"goal":{"en":"Which column the public board draws each claim in, and the case it gets wrong.","ru":"В какой колонке публичная доска рисует каждое притязание и в каком случае ошибается."},"frame":"widgets/hive-column/index.html?embed=1","widget":"The public board: which column a task's card is in","height":760},{"id":"the-comb-answers","n":27,"title":{"en":"The comb answers","ru":"Соты отвечают"},"goal":{"en":"How the game shows that something happened to a task, and how often the map grows.","ru":"Как игра показывает, что с задачей что-то случилось, и как часто растёт карта."},"frame":"widgets/hive-cell/index.html?embed=1","widget":"The comb answers: what an event does to a cell","height":760}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/t27-basics.json b/apps/website/public/widgets/course-deck/courses/t27-basics.json new file mode 100644 index 0000000000..5e71f7be79 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/t27-basics.json @@ -0,0 +1 @@ +{"id":"t27-basics","route":"t27-basics","title":{"en":"t27 basics: the language in 27 lessons","ru":"Основы t27: язык за 27 уроков"},"onePage":{"en":"/learn/all/","ru":"/ru/learn/all/"},"modules":[{"n":1,"title":{"en":"A spec file","ru":"Файл спеки"},"lessons":[{"id":"what-a-spec-is","n":1,"title":{"en":"What a spec is","ru":"Что такое спека"},"goal":{"en":"What goes into a .t27 file and what the compiler gives back for it.","ru":"Что входит в файл .t27 и что компилятор возвращает в ответ."},"frame":"widgets/basics-what-a-spec-is/index.html?embed=1","widget":"t27 basics 1: the three parts of a spec","height":640},{"id":"the-module-line","n":2,"title":{"en":"The module line","ru":"Строка module"},"goal":{"en":"How to write the module line, which names it accepts, and where it goes.","ru":"Как пишется строка module, какие имена она принимает и где стоит."},"frame":"widgets/basics-the-module-line/index.html?embed=1","widget":"t27 basics 2: the module line","height":640},{"id":"comments-and-prose","n":3,"title":{"en":"Comments and prose lines","ru":"Комментарии и строки прозы"},"goal":{"en":"Where each kind of note may stand, and the one line that breaks the parser.","ru":"Где может стоять каждый вид заметки и какая строка ломает парсер."},"frame":"widgets/basics-comments-and-prose/index.html?embed=1","widget":"t27 basics 3: where comments may stand","height":640}]},{"n":2,"title":{"en":"Values and types","ru":"Значения и типы"},"lessons":[{"id":"constants","n":4,"title":{"en":"Constants","ru":"Константы"},"goal":{"en":"The six pieces of a constant declaration and what each one does.","ru":"Шесть частей объявления константы и что делает каждая."},"frame":"widgets/basics-constants/index.html?embed=1","widget":"t27 basics 4: a constant, piece by piece","height":640},{"id":"whole-numbers","n":5,"title":{"en":"Whole numbers and their widths","ru":"Целые числа и их ширина"},"goal":{"en":"The integer types, their ranges, and the error a value too big for its type gets.","ru":"Целые типы, их диапазоны и ошибка для значения, которое не помещается в тип."},"frame":"widgets/basics-whole-numbers/index.html?embed=1","widget":"t27 basics 5: integer widths and their ranges","height":640},{"id":"true-false-and-text","n":6,"title":{"en":"True, false and text","ru":"Истина, ложь и текст"},"goal":{"en":"How to declare a bool and a str, and what a test can compare them with.","ru":"Как объявить bool и str и с чем их может сравнить тест."},"frame":"widgets/basics-true-false-and-text/index.html?embed=1","widget":"t27 basics 6: bool and str","height":640}]},{"n":3,"title":{"en":"Arrays, trits and expressions","ru":"Массивы, триты и выражения"},"lessons":[{"id":"arrays","n":7,"title":{"en":"Arrays","ru":"Массивы"},"goal":{"en":"How to declare an array, read an item, and which index is the last one.","ru":"Как объявить массив, прочитать элемент и какой индекс последний."},"frame":"widgets/basics-arrays/index.html?embed=1","widget":"t27 basics 7: an array and its indexes","height":640},{"id":"trits","n":8,"title":{"en":"Trits: minus one, zero, one","ru":"Триты: минус один, ноль, один"},"goal":{"en":"How a trit is written as a small signed constant and why 27 shows up everywhere.","ru":"Как трит записывается маленькой знаковой константой и почему 27 встречается повсюду."},"frame":"widgets/basics-trits/index.html?embed=1","widget":"t27 basics 8: three values of a trit","height":640},{"id":"expressions","n":9,"title":{"en":"Expressions","ru":"Выражения"},"goal":{"en":"Arithmetic operators and comparisons on the lesson constants, and the bool a comparison gives back.","ru":"Арифметические операторы и сравнения на константах урока и bool, который возвращает сравнение."},"frame":"widgets/basics-expressions/index.html?embed=1","widget":"t27 basics 9: operators on two numbers","height":640}]},{"n":4,"title":{"en":"Tests and functions","ru":"Тесты и функции"},"lessons":[{"id":"a-test-block","n":10,"title":{"en":"A test block","ru":"Блок test"},"goal":{"en":"How a test block is written and what a failing assert reports.","ru":"Как пишется блок test и что сообщает упавший assert."},"frame":"widgets/basics-a-test-block/index.html?embed=1","widget":"t27 basics 10: a test block, passing and failing","height":640},{"id":"many-tests","n":11,"title":{"en":"Many tests in one spec","ru":"Много тестов в одной спеке"},"goal":{"en":"Why several small tests read better than one long one, and how the report counts them.","ru":"Почему несколько маленьких тестов читаются проще одного длинного и как отчёт их считает."},"frame":"widgets/basics-many-tests/index.html?embed=1","widget":"t27 basics 11: three tests, one idea each","height":640},{"id":"functions","n":12,"title":{"en":"Functions","ru":"Функции"},"goal":{"en":"The two ways t27 writes a function signature, and the body with return.","ru":"Два способа записать сигнатуру функции в t27 и тело с return."},"frame":"widgets/basics-functions/index.html?embed=1","widget":"t27 basics 12: a function signature, piece by piece","height":640}]},{"n":5,"title":{"en":"Inside a function","ru":"Внутри функции"},"lessons":[{"id":"local-names","n":13,"title":{"en":"Local names: let and var","ru":"Локальные имена: let и var"},"goal":{"en":"When to use let and when var, and how a var is updated.","ru":"Когда нужен let, а когда var и как обновляется var."},"frame":"widgets/basics-local-names/index.html?embed=1","widget":"t27 basics 13: let, var and const","height":640},{"id":"if-and-else","n":14,"title":{"en":"Choices: if, else and switch","ru":"Выбор: if, else и switch"},"goal":{"en":"The forms of if the compiler accepts, the if expression, and switch with else.","ru":"Формы if, которые принимает компилятор, выражение if и switch с else."},"frame":"widgets/basics-if-and-else/index.html?embed=1","widget":"t27 basics 14: the shapes of a choice","height":640},{"id":"loops","n":15,"title":{"en":"Loops: while and for","ru":"Циклы: while и for"},"goal":{"en":"The three loop forms the compiler accepts and how a range is written.","ru":"Три формы цикла, которые принимает компилятор, и как пишется диапазон."},"frame":"widgets/basics-loops/index.html?embed=1","widget":"t27 basics 15: three loop forms","height":640}]},{"n":6,"title":{"en":"Visibility and your own types","ru":"Видимость и свои типы"},"lessons":[{"id":"pub-or-private","n":16,"title":{"en":"pub or private","ru":"pub или закрытое имя"},"goal":{"en":"What pub declares, and what the TypeScript backend writes with and without it.","ru":"Что объявляет pub и что пишет бэкенд TypeScript с ним и без него."},"frame":"widgets/basics-pub-or-private/index.html?embed=1","widget":"t27 basics 16: what pub changes in the generated code","height":640},{"id":"structs","n":17,"title":{"en":"Structs","ru":"Структуры"},"goal":{"en":"How to declare a struct and a packed struct, and how many a module may hold.","ru":"Как объявить struct и packed struct и сколько их может быть в модуле."},"frame":"widgets/basics-structs/index.html?embed=1","widget":"t27 basics 17: a struct and its fields","height":640},{"id":"enums","n":18,"title":{"en":"Enums","ru":"Перечисления"},"goal":{"en":"The two ways to declare an enum and how a switch reads a value.","ru":"Два способа объявить enum и как switch читает значение."},"frame":"widgets/basics-enums/index.html?embed=1","widget":"t27 basics 18: two ways to write an enum","height":640}]},{"n":7,"title":{"en":"Modules, rules and gen-ts","ru":"Модули, правила и gen-ts"},"lessons":[{"id":"use-other-modules","n":19,"title":{"en":"Using other modules","ru":"Другие модули"},"goal":{"en":"How a use line is written, and what the browser can and cannot do with it.","ru":"Как пишется строка use и что браузер может и чего не может с ней сделать."},"frame":"widgets/basics-use-other-modules/index.html?embed=1","widget":"t27 basics 19: what a use line does in the browser","height":640},{"id":"invariants","n":20,"title":{"en":"Invariants and benches","ru":"Инварианты и замеры"},"goal":{"en":"How invariant and bench blocks are written and who evaluates them.","ru":"Как пишутся блоки invariant и bench и кто их вычисляет."},"frame":"widgets/basics-invariants/index.html?embed=1","widget":"t27 basics 20: test, invariant and bench","height":640},{"id":"gen-ts","n":21,"title":{"en":"gen-ts: a spec becomes TypeScript","ru":"gen-ts: спека превращается в TypeScript"},"goal":{"en":"What gen-ts writes for constants and functions, and how a host program uses it.","ru":"Что gen-ts пишет для констант и функций и как это использует программа-хозяин."},"frame":"widgets/basics-gen-ts/index.html?embed=1","widget":"t27 basics 21: what gen-ts writes","height":640}]},{"n":8,"title":{"en":"The compiler and tri","ru":"Компилятор и tri"},"lessons":[{"id":"seven-backends","n":22,"title":{"en":"Seven backends","ru":"Семь бэкендов"},"goal":{"en":"The names of the 7 backends and how much code each wrote for one small spec.","ru":"Имена 7 бэкендов и сколько кода каждый написал для одной маленькой спеки."},"frame":"widgets/basics-seven-backends/index.html?embed=1","widget":"t27 basics 22: one spec, seven backends","height":640},{"id":"stages-of-t27c","n":23,"title":{"en":"The stages of t27c","ru":"Стадии t27c"},"goal":{"en":"The order of the compiler stages and what each one produced for the lesson spec.","ru":"Порядок стадий компилятора и что каждая выдала для спеки урока."},"frame":"widgets/basics-stages-of-t27c/index.html?embed=1","widget":"t27 basics 23: the stages of t27c, counted","height":640},{"id":"tri-commands","n":24,"title":{"en":"tri: the command line","ru":"tri: командная строка"},"goal":{"en":"What tri test does, how tri hands other words to t27c, and which commands are its own.","ru":"Что делает tri test, как tri передаёт остальные слова t27c и какие команды у него свои."},"frame":"widgets/basics-tri-commands/index.html?embed=1","widget":"t27 basics 24: where a tri command goes","height":640}]},{"n":9,"title":{"en":"Errors, a program, what next","ru":"Ошибки, программа и что дальше"},"lessons":[{"id":"reading-errors","n":25,"title":{"en":"Reading compiler errors","ru":"Как читать ошибки компилятора"},"goal":{"en":"How to read the line and column of an error, using four real mistakes.","ru":"Как читать строку и столбец ошибки на четырёх настоящих промахах."},"frame":"widgets/basics-reading-errors/index.html?embed=1","widget":"t27 basics 25: four mistakes and what t27c says","height":640},{"id":"a-small-program","n":26,"title":{"en":"A small complete program","ru":"Маленькая законченная программа"},"goal":{"en":"How the pieces of this course make one spec that becomes a circuit.","ru":"Как части этого курса складываются в одну спеку, которая становится схемой."},"frame":"widgets/basics-a-small-program/index.html?embed=1","widget":"t27 basics 26: an adder in t27 and its Verilog ports","height":640},{"id":"where-next","n":27,"title":{"en":"Where to go next","ru":"Куда дальше"},"goal":{"en":"Which course to take next, and what each one adds to the basics.","ru":"Какой курс пройти дальше и что каждый добавляет к основам."},"frame":"widgets/basics-where-next/index.html?embed=1","widget":"t27 basics 27: three courses, in order","height":640}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/ternary-computing.json b/apps/website/public/widgets/course-deck/courses/ternary-computing.json new file mode 100644 index 0000000000..28f02a0ae6 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/ternary-computing.json @@ -0,0 +1 @@ +{"id":"ternary-computing","route":"ternary-computing","title":{"en":"The ternary machine: from a trit to a running program","ru":"Троичная машина: от трита до работающей программы"},"onePage":{"en":"/learn/ternary-computing/all/","ru":"/ru/learn/ternary-computing/all/"},"modules":[{"n":1,"title":{"en":"Three values","ru":"Три значения"},"lessons":[{"id":"why-three","n":1,"title":{"en":"Why three","ru":"Почему три"},"goal":{"en":"Why base 3 is the cheapest whole base to write numbers in, and what that argument leaves out.","ru":"Почему основание 3 — самое дешёвое целое основание для записи чисел и что этот довод упускает."},"frame":"widgets/tc-why-three/index.html?embed=1","widget":"Why three: what a number costs in each base","height":640},{"id":"balanced-ternary","n":2,"title":{"en":"Balanced ternary","ru":"Сбалансированная троичная"},"goal":{"en":"How the digits -1, 0 and +1 write every integer, negative ones included, without a sign.","ru":"Как цифры -1, 0 и +1 записывают любое целое, отрицательные тоже, без знака."},"frame":"widgets/tc-balanced-count/index.html?embed=1","widget":"Balanced ternary: count with -1, 0 and +1","height":640},{"id":"flip-and-cut","n":3,"title":{"en":"Flip to negate, cut to round","ru":"Переворот вместо минуса, отсечение вместо округления"},"goal":{"en":"Why negation is a flip of every trit and truncation is already rounding.","ru":"Почему смена знака — это переворот каждого трита, а отбрасывание разрядов уже и есть округление."},"frame":"widgets/tc-flip-and-cut/index.html?embed=1","widget":"Flip every trit to negate, cut trits to round","height":640}]},{"n":2,"title":{"en":"Logic with unknown","ru":"Логика с «не знаю»"},"lessons":[{"id":"kleene-logic","n":4,"title":{"en":"Three-valued logic","ru":"Трёхзначная логика"},"goal":{"en":"How NOT, MIN and MAX extend Boolean logic with an unknown value.","ru":"Как NOT, MIN и MAX расширяют булеву логику значением «не знаю»."},"frame":"widgets/tc-kleene-gates/index.html?embed=1","widget":"Three-valued logic: NOT, MIN and MAX","height":640},{"id":"consensus-and-any","n":5,"title":{"en":"Consensus and any","ru":"Консенсус и «любой»"},"goal":{"en":"Two gates that only make sense with three values.","ru":"Два вентиля, которые имеют смысл только при трёх значениях."},"frame":"widgets/tc-consensus-any/index.html?embed=1","widget":"Consensus and any: gates binary logic does not have","height":640},{"id":"sum-and-carry","n":6,"title":{"en":"Sum and carry","ru":"Сумма и перенос"},"goal":{"en":"How the addition of two trits splits into a sum table and a carry table.","ru":"Как сложение двух тритов распадается на таблицу суммы и таблицу переноса."},"frame":"widgets/tc-sum-and-carry/index.html?embed=1","widget":"Sum and carry: addition as two gates","height":640}]},{"n":3,"title":{"en":"Adding trits","ru":"Складываем триты"},"lessons":[{"id":"half-adder","n":7,"title":{"en":"The half adder","ru":"Полусумматор"},"goal":{"en":"Two trits in, a sum trit and a carry trit out, for all nine cases.","ru":"Два трита на входе, трит суммы и трит переноса на выходе, все девять случаев."},"frame":"widgets/tc-half-adder/index.html?embed=1","widget":"The half adder: two trits in, a sum and a carry out","height":640},{"id":"full-adder","n":8,"title":{"en":"The full adder","ru":"Полный сумматор"},"goal":{"en":"Why three trits still fit one sum trit and one carry trit.","ru":"Почему три трита всё ещё умещаются в один трит суммы и один трит переноса."},"frame":"widgets/tc-full-adder/index.html?embed=1","widget":"The full adder: a carry comes in, a carry goes out","height":640},{"id":"ripple-carry","n":9,"title":{"en":"Ripple carry","ru":"Сквозной перенос"},"goal":{"en":"How a row of full adders adds two numbers, the carry walking left.","ru":"Как ряд полных сумматоров складывает два числа, а перенос идёт влево."},"frame":"widgets/tc-ripple-carry/index.html?embed=1","widget":"Ripple carry: add two numbers trit by trit","height":640}]},{"n":4,"title":{"en":"Multiplying without a multiplier","ru":"Умножение без умножителя"},"lessons":[{"id":"times-a-trit","n":10,"title":{"en":"Times one trit","ru":"Умножить на один трит"},"goal":{"en":"Why multiplying by -1, 0 or +1 is a switch, not a multiplier.","ru":"Почему умножение на -1, 0 или +1 — это переключатель, а не умножитель."},"frame":"widgets/tc-times-a-trit/index.html?embed=1","widget":"Times one trit: copy, drop or flip","height":640},{"id":"long-multiplication","n":11,"title":{"en":"Long multiplication","ru":"Умножение столбиком"},"goal":{"en":"How n x m becomes rows of copies, zeros and flips.","ru":"Как n x m превращается в строки копий, нулей и переворотов."},"frame":"widgets/tc-long-multiply/index.html?embed=1","widget":"Long multiplication in balanced ternary","height":640},{"id":"ternary-mac","n":12,"title":{"en":"A ternary MAC","ru":"Троичный MAC"},"goal":{"en":"How a dot product with ternary weights becomes adds, subtracts and skips.","ru":"Как скалярное произведение с троичными весами превращается в сложения, вычитания и пропуски."},"frame":"widgets/tc-ternary-mac/index.html?embed=1","widget":"A MAC with ternary weights: add, subtract or skip","height":640}]},{"n":5,"title":{"en":"Trits in binary memory","ru":"Триты в двоичной памяти"},"lessons":[{"id":"two-bits-per-trit","n":13,"title":{"en":"Two bits per trit","ru":"Два бита на трит"},"goal":{"en":"What it costs to store a trit in binary the simple way.","ru":"Во что обходится хранить трит в двоичной памяти простым способом."},"frame":"widgets/tc-two-bits/index.html?embed=1","widget":"A trit in two bits, and the code nobody uses","height":640},{"id":"five-trits-a-byte","n":14,"title":{"en":"Five trits in a byte","ru":"Пять тритов в байте"},"goal":{"en":"How 3^5 = 243 fits under 2^8 = 256, and what the 13 spare codes mean.","ru":"Как 3^5 = 243 умещается под 2^8 = 256 и что значат 13 лишних кодов."},"frame":"widgets/tc-five-in-a-byte/index.html?embed=1","widget":"Five trits in one byte: 243 of 256 codes","height":640},{"id":"a-word-of-27","n":15,"title":{"en":"A word of 27 trits","ru":"Слово из 27 тритов"},"goal":{"en":"How many bits a 27-trit word needs, and how close to full it runs.","ru":"Сколько бит нужно слову из 27 тритов и насколько плотно оно их использует."},"frame":"widgets/tc-trit-word/index.html?embed=1","widget":"A word of 27 trits and the 43 bits it needs","height":640}]},{"n":6,"title":{"en":"The TRI-27 instruction word","ru":"Командное слово TRI-27"},"lessons":[{"id":"the-instruction-word","n":16,"title":{"en":"The instruction word","ru":"Командное слово"},"goal":{"en":"How the TRI-27 emulator packs an instruction into 32 bits.","ru":"Как эмулятор TRI-27 упаковывает команду в 32 бита."},"frame":"widgets/tc-instruction-word/index.html?embed=1","widget":"The TRI-27 instruction word, field by field","height":640},{"id":"the-opcode-map","n":17,"title":{"en":"The opcode map","ru":"Карта опкодов"},"goal":{"en":"Which of the 256 opcode bytes mean something, and what the rest do.","ru":"Какие из 256 байтов опкода что-то значат и что делают остальные."},"frame":"widgets/tc-opcode-map/index.html?embed=1","widget":"The opcode map: 47 of 256 bytes mean something","height":640},{"id":"the-immediate","n":18,"title":{"en":"The immediate","ru":"Непосредственное значение"},"goal":{"en":"How a 15-bit signed immediate is clamped, stored and read back.","ru":"Как 15-битное знаковое непосредственное значение обрезается, хранится и читается обратно."},"frame":"widgets/tc-immediate/index.html?embed=1","widget":"The immediate: fifteen bits, clamped, and read back","height":640}]},{"n":7,"title":{"en":"A ternary machine","ru":"Троичная машина"},"lessons":[{"id":"a-ternary-alu","n":19,"title":{"en":"A ternary ALU","ru":"Троичное АЛУ"},"goal":{"en":"How add, subtract, negate and compare work on 9-trit registers.","ru":"Как сложение, вычитание, смена знака и сравнение работают на 9-тритных регистрах."},"frame":"widgets/tc-ternary-alu/index.html?embed=1","widget":"A ternary ALU built from this course's adders","height":640},{"id":"three-way-jump","n":20,"title":{"en":"A three-way jump","ru":"Переход на три стороны"},"goal":{"en":"Why one ternary compare can branch three ways.","ru":"Почему одно троичное сравнение может ветвиться на три стороны."},"frame":"widgets/tc-three-way-jump/index.html?embed=1","widget":"A three-way jump: one compare, three targets","height":640},{"id":"run-a-program","n":21,"title":{"en":"Run a program","ru":"Запустить программу"},"goal":{"en":"How five instructions and one three-way jump make a loop that ends itself.","ru":"Как пять команд и один переход на три стороны дают цикл, который сам себя завершает."},"frame":"widgets/tc-run-a-program/index.html?embed=1","widget":"Run a program on a ternary machine","height":640}]},{"n":8,"title":{"en":"Three answers","ru":"Три ответа"},"lessons":[{"id":"compare-at-the-top","n":22,"title":{"en":"Compare at the top","ru":"Сравнение сверху"},"goal":{"en":"Why balanced-ternary numbers compare at their first differing trit.","ru":"Почему числа в сбалансированной троичной сравниваются по первому различному триту."},"frame":"widgets/tc-compare/index.html?embed=1","widget":"Compare at the first differing trit","height":640},{"id":"questions-in-thirds","n":23,"title":{"en":"Questions in thirds","ru":"Вопросы по третям"},"goal":{"en":"Why three-answer questions find a number faster, and spell it as they go.","ru":"Почему вопросы с тремя ответами находят число быстрее и попутно записывают его."},"frame":"widgets/tc-thirds/index.html?embed=1","widget":"Twenty questions in thirds","height":640},{"id":"sort-by-three","n":24,"title":{"en":"Sort with three-way compares","ru":"Сортировка трёхзначными сравнениями"},"goal":{"en":"How a sort uses compares that also answer equal.","ru":"Как сортировка пользуется сравнениями, которые умеют ответить «равно»."},"frame":"widgets/tc-sort-three/index.html?embed=1","widget":"Sort three numbers with three-way compares","height":640}]},{"n":9,"title":{"en":"Ternary neurons","ru":"Троичные нейроны"},"lessons":[{"id":"one-ternary-neuron","n":25,"title":{"en":"One ternary neuron","ru":"Один троичный нейрон"},"goal":{"en":"How a neuron with weights -1, 0, +1 computes without multiplying.","ru":"Как нейрон с весами -1, 0, +1 считает без умножения."},"frame":"widgets/tc-one-neuron/index.html?embed=1","widget":"One ternary neuron: inputs, weights, a threshold","height":640},{"id":"a-bar-detector","n":26,"title":{"en":"A bar detector","ru":"Детектор полосы"},"goal":{"en":"Why a neuron's weights work as a template.","ru":"Почему веса нейрона работают как шаблон."},"frame":"widgets/tc-detector/index.html?embed=1","widget":"A bar detector: one neuron, four patterns","height":640},{"id":"a-tiny-layer","n":27,"title":{"en":"A tiny layer","ru":"Маленький слой"},"goal":{"en":"How several neurons reading one input describe it with a few trits.","ru":"Как несколько нейронов, читающих один вход, описывают его парой тритов."},"frame":"widgets/tc-tiny-layer/index.html?embed=1","widget":"A layer of three ternary neurons","height":640}]}]} diff --git a/apps/website/public/widgets/course-deck/courses/verify-hardware.json b/apps/website/public/widgets/course-deck/courses/verify-hardware.json new file mode 100644 index 0000000000..b3b8006a56 --- /dev/null +++ b/apps/website/public/widgets/course-deck/courses/verify-hardware.json @@ -0,0 +1 @@ +{"id":"verify-hardware","route":"verify-hardware","title":{"en":"Verifying hardware with t27: testbenches, waveforms, formal, mutation","ru":"Проверка железа с t27: тестбенчи, временные диаграммы, формальные методы, мутации"},"onePage":{"en":"/learn/verify-hardware/all/","ru":"/ru/learn/verify-hardware/all/"},"modules":[{"n":1,"title":{"en":"Why verify","ru":"Зачем проверять"},"lessons":[{"id":"bugs-that-compile","n":1,"title":{"en":"Bugs that compile","ru":"Баги, которые компилируются"},"goal":{"en":"Why a clean compile proves so little, and what a seal without output is worth.","ru":"Почему чистая компиляция доказывает так мало и чего стоит печать без вывода."},"frame":"term/t27-tri-seals/index.html","widget":"tri seals: hollow seals that pass every check","height":640},{"id":"golden-model","n":2,"title":{"en":"The golden model","ru":"Золотая модель"},"goal":{"en":"What a reference model is, and how a conformance suite holds a tool to it.","ru":"Что такое эталонная модель и как набор соответствия держит инструмент в рамках."},"frame":"term/tri-fpga-specs/index.html","widget":"tri fpga-specs: every board spec, compiled and tested","height":640},{"id":"plan-before-code","n":3,"title":{"en":"Plan before code","ru":"Сначала план"},"goal":{"en":"How a verification plan is a checklist that a command can sweep and sign.","ru":"Как план проверки превращается в чек-лист, который команда может прогнать и подписать."},"frame":"term/tri-fpga-tools/index.html","widget":"tri fpga-tools · 14 bench tools test themselves","height":640}]},{"n":2,"title":{"en":"Testbenches","ru":"Тестбенчи"},"lessons":[{"id":"anatomy-of-a-tb","n":4,"title":{"en":"Anatomy of a testbench","ru":"Анатомия тестбенча"},"goal":{"en":"The parts every *_tb.t27 spec has: stimulus, expected values, checks, a verdict.","ru":"Из чего состоит каждый *_tb.t27: стимулы, ожидания, проверки, вердикт."},"frame":"play/embed.html?spec=specs%2Fdemos%2Fhello_world.t27&cast=t27c-hello-world&tab=term&backend=js&v=7cbe9ab0c960","widget":"hello_world.t27 to JavaScript, in a terminal inside the post","height":480},{"id":"self-checking","n":5,"title":{"en":"Self-checking, not staring","ru":"Самопроверка вместо всматривания"},"goal":{"en":"How to write a testbench that fails loudly, and why eyeballing waves is not a check.","ru":"Как написать тестбенч, который падает громко, и почему разглядывание волн — не проверка."},"frame":"term/play-terminal-gates/index.html","widget":"t27 play · the terminal's own gates","height":640},{"id":"directed-vs-random","n":6,"title":{"en":"Directed versus random","ru":"Направленные против случайных"},"goal":{"en":"When one carefully chosen case beats a thousand random ones, and when it does not.","ru":"Когда один выбранный случай стоит тысячи случайных, а когда нет."},"frame":"term/perf2-knockouts/index.html","widget":"Three PERF2 bits, and one knockout bitstream per bit","height":640}]},{"n":3,"title":{"en":"Waveforms","ru":"Временные диаграммы"},"lessons":[{"id":"vcd-format","n":7,"title":{"en":"The VCD format","ru":"Формат VCD"},"goal":{"en":"What a .vcd file actually contains, and how to read its dump of every signal.","ru":"Что на самом деле лежит в .vcd-файле и как читать его дамп всех сигналов."},"frame":"widgets/vcd-wrapped/index.html?embed=1","widget":"VCD wrapped: your simulation, summed up on one card","height":640},{"id":"debug-with-waves","n":8,"title":{"en":"Debug with waves","ru":"Отладка по волнам"},"goal":{"en":"How to go from a symptom to a signal, cycle by cycle, on a real measured bug.","ru":"Как пройти от симптома к сигналу, такт за тактом, на настоящем измеренном баге."},"frame":"term/tri-fpga-wire/index.html","widget":"tri fpga-wire · the baud rate actually on the wire","height":640},{"id":"compare-traces","n":9,"title":{"en":"Compare two traces","ru":"Сравнение двух трасс"},"goal":{"en":"How to diff two runs and have the trace name the earliest cycle where they split.","ru":"Как сравнить два прогона и пусть трасса назовёт самый ранний такт расхождения."},"frame":"widgets/bit-diff/index.html?embed=1","widget":"Bitstream diff: two 7-series .bit files, frame by frame","height":640}]},{"n":4,"title":{"en":"Conformance vectors","ru":"Векторы соответствия"},"lessons":[{"id":"what-a-vector-is","n":10,"title":{"en":"What a vector is","ru":"Что такое вектор"},"goal":{"en":"What a test vector is, and why the answer belongs beside the input, in the file.","ru":"Что такое тест-вектор и почему ответ должен лежать рядом со входом, в файле."},"frame":"term/t27-tri-vectors/index.html","widget":"tri vectors debt: tests that are prose","height":640},{"id":"golden-ruler-vectors","n":11,"title":{"en":"Golden ruler vectors","ru":"Векторы как эталонная линейка"},"goal":{"en":"How a catalog works as a ruler: every population recounted, every count agreeing.","ru":"Как каталог работает линейкой: каждая популяция пересчитана, каждый счёт сходится."},"frame":"term/t27-tri-census/index.html","widget":"tri census audit: every census, counted twice","height":640},{"id":"end-to-end-scenarios","n":12,"title":{"en":"End-to-end scenarios","ru":"Сквозные сценарии"},"goal":{"en":"How a scenario walks a whole flow, and what an end-to-end run proves that units cannot.","ru":"Как сценарий проходит весь поток и что сквозной прогон доказывает, чего не могут юниты."},"frame":"term/devkit-flow/index.html","widget":"tri devkit · the FPGA flow, layer by layer","height":640}]},{"n":5,"title":{"en":"Cosimulation","ru":"Косимуляция"},"lessons":[{"id":"three-way-agreement","n":13,"title":{"en":"Three-way agreement","ru":"Тройное согласие"},"goal":{"en":"How spec, simulator and board are held to one answer, and what each one is trusted for.","ru":"Как spec, симулятор и плата приводятся к одному ответу и чему каждая сторона доверена."},"frame":"term/tri-fpga-batch/index.html","widget":"tri fpga-batch-rehearsal · the batched wire protocol, rehearsed off-board","height":640},{"id":"simulator-internals","n":14,"title":{"en":"Inside the simulator","ru":"Внутри симулятора"},"goal":{"en":"What a simulator keeps (state) and what it does not (time between events).","ru":"Что симулятор хранит (состояние) и чего не хранит (время между событиями)."},"frame":"term/tri-fpga-status/index.html","widget":"tri fpga-status · the bench at a glance","height":640},{"id":"when-they-disagree","n":15,"title":{"en":"When they disagree","ru":"Когда они не сходятся"},"goal":{"en":"How to triage a disagreement: which of the three is lying, and how to find out.","ru":"Как разбирать расхождение: кто из трёх врёт и как это узнать."},"frame":"term/tri-fpga-pins/index.html","widget":"tri fpga-pins · the blast radius of an edit, before the edit","height":640}]},{"n":6,"title":{"en":"Coverage","ru":"Покрытие"},"lessons":[{"id":"line-and-toggle","n":16,"title":{"en":"Line and toggle","ru":"Строки и переключения"},"goal":{"en":"How line and toggle coverage count what a run touched, signal bit by signal bit.","ru":"Как построчное покрытие и покрытие переключений считают, чего прогон коснулся, бит за битом."},"frame":"widgets/resource-bars/index.html?embed=1","widget":"Resource bars: LUT, FF, BRAM and DSP used on the XC7A200T","height":640},{"id":"fsm-coverage","n":17,"title":{"en":"FSM coverage","ru":"Покрытие автоматов"},"goal":{"en":"How state and transition coverage see the arcs a run never took.","ru":"Как покрытие состояний и переходов видит дуги, по которым прогон так и не прошёл."},"frame":"term/tri-fpga-tmpcheck/index.html","widget":"tri fpga-tmpcheck · every /tmp file a spec pins, kept","height":640},{"id":"coverage-lies","n":18,"title":{"en":"Coverage lies","ru":"Покрытие лжёт"},"goal":{"en":"Why a coverage number can be a check that checked nothing, and how to spot it.","ru":"Почему процент покрытия бывает проверкой, которая ничего не проверила, и как это распознать."},"frame":"term/t27-tri-prose/index.html","widget":"tri prose report: prose, or code?","height":640}]},{"n":7,"title":{"en":"Formal","ru":"Формальные методы"},"lessons":[{"id":"assertions","n":19,"title":{"en":"Assertions","ru":"Ассерты"},"goal":{"en":"What an assertion is in code, and what it costs to check one every cycle.","ru":"Что такое ассерт в коде и сколько стоит проверять его каждый такт."},"frame":"term/tri-selftest/index.html","widget":"tri selftest: the dependencies tri needs","height":640},{"id":"bounded-model-checking","n":20,"title":{"en":"Bounded model checking","ru":"Ограниченная проверка моделей"},"goal":{"en":"How a bounded search explores every input up to k cycles, and what that proves.","ru":"Как ограниченный перебор исследует все входы до k тактов и что это доказывает."},"frame":"term/tri-fpga-keycheck/index.html","widget":"tri fpga-keycheck: the key is counted, never printed","height":640},{"id":"induction","n":21,"title":{"en":"Induction","ru":"Индукция"},"goal":{"en":"Why bounded is not a proof, and how induction closes the gap -- or reports it cannot.","ru":"Почему ограниченность — не доказательство и как индукция закрывает разрыв — или честно сообщает, что не может."},"frame":"term/t27-tri-lean/index.html","widget":"tri lean: proofs that nothing compiles","height":640}]},{"n":8,"title":{"en":"Mutation","ru":"Мутации"},"lessons":[{"id":"kill-the-mutant","n":22,"title":{"en":"Kill the mutant","ru":"Убить мутанта"},"goal":{"en":"How mutation testing plants a bug on purpose and asks the tests to notice.","ru":"Как мутационное тестирование переворачивает игру: ломайте дизайн нарочно и смотрите, заметят ли тесты."},"frame":"term/tri-x7-mutate/index.html","widget":"tri x7-mutate · plant a bug, the tests must catch it","height":640},{"id":"surviving-mutants","n":23,"title":{"en":"Surviving mutants","ru":"Выжившие мутанты"},"goal":{"en":"What a surviving mutant tells you about the test that let it live.","ru":"Что выживший мутант говорит о тесте, который его пропустил."},"frame":"widgets/test-touch/index.html?embed=1","widget":"Did the agent touch its own tests? Every PR merged on t27, checked","height":640},{"id":"test-strength","n":24,"title":{"en":"Test strength","ru":"Сила тестов"},"goal":{"en":"How to measure a suite, not admire it: caught mutants, deleted tests, vacuous passes.","ru":"Как измерить набор тестов, а не любоваться им: убитые мутанты, удалённые тесты, доля пустых проходов."},"frame":"term/tri-x7-refs/index.html","widget":"tri x7-part · x7-refs · x7-bench: the references the bitstream path is checked on","height":640}]},{"n":9,"title":{"en":"Sign-off","ru":"Приёмка"},"lessons":[{"id":"build-verify","n":25,"title":{"en":"Build and verify","ru":"Сборка и проверка"},"goal":{"en":"How one command re-runs every sweep and turns a build into a verdict.","ru":"Как одна команда пересобирает вердикт заново."},"frame":"term/tri-x7-audit/index.html","widget":"tri x7-audit · the whole bitstream path, re-checked","height":640},{"id":"board-selftest","n":26,"title":{"en":"The board self-tests","ru":"Стенд проверяет себя"},"goal":{"en":"How the bench checks itself: every script running its own self-test, nothing skipped.","ru":"Как стенд проверяет себя перед проверкой вашего дизайна."},"frame":"term/tri-fpga-selftest/index.html","widget":"tri fpga-selftest: off-board self-tests, no port opened","height":640},{"id":"verify-capstone","n":27,"title":{"en":"Capstone: verify a module whole","ru":"Капстоун: проверить модуль целиком"},"goal":{"en":"Carry one module from spec to board with the whole verification stack behind it.","ru":"Провести один модуль от spec до платы со всем проверочным стеком за спиной."},"frame":"term/perf2-loop/index.html","widget":"Place and route to a loaded bitstream, timed","height":640}]}]} diff --git a/apps/website/public/widgets/course-deck/index.html b/apps/website/public/widgets/course-deck/index.html new file mode 100644 index 0000000000..7dffb76b88 --- /dev/null +++ b/apps/website/public/widgets/course-deck/index.html @@ -0,0 +1,48 @@ + + + + + + +Course deck: a t27 course, module by module, widget by widget · Trinity S³AI + + + + + + + + + + + + + + + + + + + + + + + + +
+Trinity S³AI +

Course deck: a t27 course, module by module, widget by widget

+

Any free t27.ai course in one embed: nine module tabs, three lesson cards each, every card running that lesson's own widget, loaded only as you reach it.

+
+
+ +
+

This page sets no cookie and sends nothing anywhere.

+
Where the numbers come from
  • The course specs specs/course/*.t27 and their Russian bundles, read by scripts/course-from-spec.mjs and written beside this page as courses/<course>.json by scripts/course-pages.mjs
  • The frame budget and the load margins of specs/view/course-view.t27, held equal to the K_ numbers here by scripts/course-view-from-spec.mjs
+

This widget's .t27 source · All widgets

+
+ + + + + diff --git a/apps/website/public/widgets/gallery.t27 b/apps/website/public/widgets/gallery.t27 index fb07268ccf..6f1adea6ff 100644 --- a/apps/website/public/widgets/gallery.t27 +++ b/apps/website/public/widgets/gallery.t27 @@ -78,15 +78,15 @@ pub const TOOL_NOSCRIPT : str = "This widget runs in your browser and needs Java ; Parallel arrays, WIDGET_COUNT long. WIDGET_TITLES is empty wherever the page carries an ; og:title, which is every kind but tab: the page is the one place the words live. A tool's ; WIDGET_HOOKS entry is empty too: its hook is the page's t27:hook, written from its own spec. -pub const WIDGET_COUNT : u16 = 306; -pub const WIDGET_IDS : [306]str = ["x7-board", "tri-x7-fasm", "tri-x7-mutate", "perf2-loop", "tri-fpga-rgmii", "tri-fpga-jtag", "tri-fpga-pins", "devkit-flow", "play-verilog", "bit-diff", "build-receipt", "cost-curves", "gf16-calc", "idcode", "lut-explain", "pin-map", "placement-map", "resource-bars", "slack-waterfall", "test-waves", "synth-smells", "bit-autopsy", "fasm-skyline", "vcd-wrapped", "fits-on", "stat-card", "lut-depth", "fsm-sketch", "lut-treemap", "t27-cell", "t27-vs-nvfp4", "uart-bucket", "tri-fpga-specs", "tri-fpga-tools", "tri-fpga-wire", "tri-fpga-batch", "tri-fpga-status", "tri-fpga-tmpcheck", "tri-fpga-keycheck", "tri-fpga-selftest", "tri-x7-refs", "tri-x7-audit", "t27c-clock-domain", "t27c-clocks", "t27c-wukong-v1", "t27c-cts", "t27c-mmcm", "t27c-mmcm-mutate", "t27c-timing", "t27c-reset-sync", "t27c-reset-sync-gen", "t27c-mtbf", "t27c-clock-domain-gen", "t27c-fifo", "t27c-fifo-mutate", "t27c-fifo-flags", "t27c-emitter-xdc", "t27c-fpga-rxcap", "t27-tri-competitors", "t27-tri-discard", "tri-fpga-txhold", "tri-fpga-rxcap", "tri-fpga-rxer", "tri-fpga-steps", "tri-fpga-ioclients", "tri-fpga-claim", "tri-fpga-release", "tri-fpga-next", "t27c-memory", "t27c-spi-tb", "t27c-check-uart", "t27c-check-spi", "t27c-check-apb", "t27c-check-axi4", "t27c-check-bridge", "t27c-check-memory", "t27c-verilog-uart", "t27c-verilog-spi", "t27c-verilog-apb", "t27c-verilog-axi4", "t27c-verilog-bridge", "t27c-verilog-top", "t27c-verilog-uart-tb", "t27c-verilog-apb-tb", "t27c-verilog-axi-tb", "t27c-verilog-mem-tb", "t27c-verilog-integration-tb", "t27c-verilog-top-tb", "t27c-verilog-spi-tb", "t27c-hir-uart", "t27c-hir-apb", "t27c-hir-axi4", "t27c-eth-crc", "t27c-rgmii", "jtag-verdict", "line-bounce", "eye-isi", "ecc-secded", "carry-chain", "prefix-adder", "csa-tree", "shift-add", "booth-radix4", "dsp-fit", "q-format", "round-sat", "sqnr", "cordic", "cordic-vector", "sine-table", "alias-fold", "nco", "dft-bin", "fir-response", "fir-design", "fir-cost", "decimator", "cic-growth", "polyphase", "fft-butterfly", "bit-reverse", "fft-scaling", "barker-corr", "fir-fit", "fir-on-board", "play-hello-world", "play-rust", "play-js", "t27c-hello-world", "t27-tri-misread", "test-touch", "t27c-stages", "t27c-e8m0", "play-e8m0", "t27c-ocp-mx", "play-gfternary", "t27c-gfternary", "play-golden-sieve", "t27c-golden-sieve", "play-tnf17", "t27c-tnf17", "t27c-activation-quantizer", "t27c-bitnet-majority", "t27c-bitnet-neuron-nchunk", "t27c-comb-ternary-dot", "t27c-stream-ternary-mac", "t27c-bitnet-mlp", "t27c-gft-smul", "t27c-gft-sadd", "t27c-gft-signed-mac", "t27c-gft-relu", "t27c-gft-exp2", "t27c-gft-argmax4", "t27c-gft-nll", "t27c-gft-sgd-step", "t27c-gft-xornet", "basics-what-a-spec-is", "basics-the-module-line", "basics-comments-and-prose", "basics-constants", "basics-whole-numbers", "basics-true-false-and-text", "basics-arrays", "basics-trits", "basics-expressions", "basics-a-test-block", "basics-many-tests", "basics-functions", "basics-local-names", "basics-if-and-else", "basics-loops", "basics-pub-or-private", "basics-structs", "basics-enums", "basics-use-other-modules", "basics-invariants", "basics-gen-ts", "basics-seven-backends", "basics-stages-of-t27c", "basics-tri-commands", "basics-reading-errors", "basics-a-small-program", "basics-where-next", "golden-split", "golden-phi-ratio", "golden-lucas", "golden-split-optimality", "golden-radix-economy", "golden-phi-in-gf16", "golden-gf4", "golden-gf6", "golden-gf8", "golden-gf10", "golden-gf12", "golden-gf14", "golden-gf16", "golden-dot-two", "golden-gf24", "golden-gf32", "golden-gf48", "golden-gf64", "golden-gf96", "golden-gf128", "golden-gf256", "golden-gf512", "golden-gf1024", "golden-gft8", "golden-gft16", "golden-gft32", "golden-decode", "t27-tri-vectors", "t27-tri-census", "t27-tri-seals", "t27-tri-prose", "t27-tri-lean", "tri-selftest", "play-terminal-gates", "tc-why-three", "tc-balanced-count", "tc-flip-and-cut", "tc-kleene-gates", "tc-consensus-any", "tc-sum-and-carry", "tc-half-adder", "tc-full-adder", "tc-ripple-carry", "tc-times-a-trit", "tc-long-multiply", "tc-ternary-mac", "tc-two-bits", "tc-five-in-a-byte", "tc-trit-word", "tc-instruction-word", "tc-opcode-map", "tc-immediate", "tc-ternary-alu", "tc-three-way-jump", "tc-run-a-program", "tc-compare", "tc-thirds", "tc-sort-three", "tc-one-neuron", "tc-detector", "tc-tiny-layer", "nn-relu", "nn-sigmoid", "nn-tanh", "nn-gelu", "nn-silu", "nn-elu", "nn-softmax", "nn-embedding", "nn-dropout", "nn-conv", "nn-maxpool", "nn-batchnorm", "nn-mse", "nn-bce", "nn-huber", "nn-sgd", "nn-rmsprop", "nn-adam", "nn-backprop", "nn-xor", "nn-lamb", "nn-rnn", "nn-lstm", "nn-attention", "nn-positions", "nn-encoder", "nn-ppo", "hive-shape", "hive-boundary", "hive-task-filter", "hive-aging", "hive-rank", "hive-review-first", "hive-lifecycle", "hive-ship", "hive-drain", "hive-reviewers", "hive-revisit", "hive-gate", "hive-jam", "hive-jam-action", "hive-master-red", "hive-key-error", "hive-key-rest", "hive-next-key", "hive-credit", "hive-price", "hive-burn", "hive-called", "hive-chain", "hive-cooldown", "hive-night", "hive-column", "hive-cell", "wars", "tri-game-tick", "tri-game-vault", "perf2-knockouts", "race-the-bee", "gatle", "tri-blog-list", "tri-game-selftest"]; -pub const WIDGET_KINDS : [306]str = ["cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "player", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "player", "player", "player", "cast", "cast", "tool", "tool", "cast", "player", "cast", "player", "cast", "player", "cast", "player", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tab", "cast", "cast", "cast", "tool", "tool", "cast", "cast"]; -pub const WIDGET_CATEGORIES : [306]str = ["fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game"]; -pub const WIDGET_PAGES : [306]str = ["term/x7-board/", "term/tri-x7-fasm/", "term/tri-x7-mutate/", "term/perf2-loop/", "term/tri-fpga-rgmii/", "term/tri-fpga-jtag/", "term/tri-fpga-pins/", "term/devkit-flow/", "play/hello-world/verilog/", "widgets/bit-diff/", "widgets/build-receipt/", "widgets/cost-curves/", "widgets/gf16-calc/", "widgets/idcode/", "widgets/lut-explain/", "widgets/pin-map/", "widgets/placement-map/", "widgets/resource-bars/", "widgets/slack-waterfall/", "widgets/test-waves/", "widgets/synth-smells/", "widgets/bit-autopsy/", "widgets/fasm-skyline/", "widgets/vcd-wrapped/", "widgets/fits-on/", "widgets/stat-card/", "widgets/lut-depth/", "widgets/fsm-sketch/", "widgets/lut-treemap/", "widgets/t27-cell/", "widgets/t27-vs-nvfp4/", "widgets/uart-bucket/", "term/tri-fpga-specs/", "term/tri-fpga-tools/", "term/tri-fpga-wire/", "term/tri-fpga-batch/", "term/tri-fpga-status/", "term/tri-fpga-tmpcheck/", "term/tri-fpga-keycheck/", "term/tri-fpga-selftest/", "term/tri-x7-refs/", "term/tri-x7-audit/", "term/t27c-clock-domain/", "term/t27c-clocks/", "term/t27c-wukong-v1/", "term/t27c-cts/", "term/t27c-mmcm/", "term/t27c-mmcm-mutate/", "term/t27c-timing/", "term/t27c-reset-sync/", "term/t27c-reset-sync-gen/", "term/t27c-mtbf/", "term/t27c-clock-domain-gen/", "term/t27c-fifo/", "term/t27c-fifo-mutate/", "term/t27c-fifo-flags/", "term/t27c-emitter-xdc/", "term/t27c-fpga-rxcap/", "term/t27-tri-competitors/", "term/t27-tri-discard/", "term/tri-fpga-txhold/", "term/tri-fpga-rxcap/", "term/tri-fpga-rxer/", "term/tri-fpga-steps/", "term/tri-fpga-ioclients/", "term/tri-fpga-claim/", "term/tri-fpga-release/", "term/tri-fpga-next/", "term/t27c-memory/", "term/t27c-spi-tb/", "term/t27c-check-uart/", "term/t27c-check-spi/", "term/t27c-check-apb/", "term/t27c-check-axi4/", "term/t27c-check-bridge/", "term/t27c-check-memory/", "term/t27c-verilog-uart/", "term/t27c-verilog-spi/", "term/t27c-verilog-apb/", "term/t27c-verilog-axi4/", "term/t27c-verilog-bridge/", "term/t27c-verilog-top/", "term/t27c-verilog-uart-tb/", "term/t27c-verilog-apb-tb/", "term/t27c-verilog-axi-tb/", "term/t27c-verilog-mem-tb/", "term/t27c-verilog-integration-tb/", "term/t27c-verilog-top-tb/", "term/t27c-verilog-spi-tb/", "term/t27c-hir-uart/", "term/t27c-hir-apb/", "term/t27c-hir-axi4/", "term/t27c-eth-crc/", "term/t27c-rgmii/", "widgets/jtag-verdict/", "widgets/line-bounce/", "widgets/eye-isi/", "widgets/ecc-secded/", "widgets/carry-chain/", "widgets/prefix-adder/", "widgets/csa-tree/", "widgets/shift-add/", "widgets/booth-radix4/", "widgets/dsp-fit/", "widgets/q-format/", "widgets/round-sat/", "widgets/sqnr/", "widgets/cordic/", "widgets/cordic-vector/", "widgets/sine-table/", "widgets/alias-fold/", "widgets/nco/", "widgets/dft-bin/", "widgets/fir-response/", "widgets/fir-design/", "widgets/fir-cost/", "widgets/decimator/", "widgets/cic-growth/", "widgets/polyphase/", "widgets/fft-butterfly/", "widgets/bit-reverse/", "widgets/fft-scaling/", "widgets/barker-corr/", "widgets/fir-fit/", "widgets/fir-on-board/", "play/hello-world/", "play/hello-world/rust/", "play/hello-world/js/", "term/t27c-hello-world/", "term/t27-tri-misread/", "widgets/test-touch/", "widgets/t27c-stages/", "term/t27c-e8m0/", "play/e8m0/", "term/t27c-ocp-mx/", "play/gfternary/", "term/t27c-gfternary/", "play/golden-sieve/", "term/t27c-golden-sieve/", "play/tnf17/", "term/t27c-tnf17/", "term/t27c-activation-quantizer/", "term/t27c-bitnet-majority/", "term/t27c-bitnet-neuron-nchunk/", "term/t27c-comb-ternary-dot/", "term/t27c-stream-ternary-mac/", "term/t27c-bitnet-mlp/", "term/t27c-gft-smul/", "term/t27c-gft-sadd/", "term/t27c-gft-signed-mac/", "term/t27c-gft-relu/", "term/t27c-gft-exp2/", "term/t27c-gft-argmax4/", "term/t27c-gft-nll/", "term/t27c-gft-sgd-step/", "term/t27c-gft-xornet/", "widgets/basics-what-a-spec-is/", "widgets/basics-the-module-line/", "widgets/basics-comments-and-prose/", "widgets/basics-constants/", "widgets/basics-whole-numbers/", "widgets/basics-true-false-and-text/", "widgets/basics-arrays/", "widgets/basics-trits/", "widgets/basics-expressions/", "widgets/basics-a-test-block/", "widgets/basics-many-tests/", "widgets/basics-functions/", "widgets/basics-local-names/", "widgets/basics-if-and-else/", "widgets/basics-loops/", "widgets/basics-pub-or-private/", "widgets/basics-structs/", "widgets/basics-enums/", "widgets/basics-use-other-modules/", "widgets/basics-invariants/", "widgets/basics-gen-ts/", "widgets/basics-seven-backends/", "widgets/basics-stages-of-t27c/", "widgets/basics-tri-commands/", "widgets/basics-reading-errors/", "widgets/basics-a-small-program/", "widgets/basics-where-next/", "widgets/golden-split/", "widgets/golden-phi-ratio/", "widgets/golden-lucas/", "widgets/golden-split-optimality/", "widgets/golden-radix-economy/", "widgets/golden-phi-in-gf16/", "widgets/golden-gf4/", "widgets/golden-gf6/", "widgets/golden-gf8/", "widgets/golden-gf10/", "widgets/golden-gf12/", "widgets/golden-gf14/", "widgets/golden-gf16/", "widgets/golden-dot-two/", "widgets/golden-gf24/", "widgets/golden-gf32/", "widgets/golden-gf48/", "widgets/golden-gf64/", "widgets/golden-gf96/", "widgets/golden-gf128/", "widgets/golden-gf256/", "widgets/golden-gf512/", "widgets/golden-gf1024/", "widgets/golden-gft8/", "widgets/golden-gft16/", "widgets/golden-gft32/", "widgets/golden-decode/", "term/t27-tri-vectors/", "term/t27-tri-census/", "term/t27-tri-seals/", "term/t27-tri-prose/", "term/t27-tri-lean/", "term/tri-selftest/", "term/play-terminal-gates/", "widgets/tc-why-three/", "widgets/tc-balanced-count/", "widgets/tc-flip-and-cut/", "widgets/tc-kleene-gates/", "widgets/tc-consensus-any/", "widgets/tc-sum-and-carry/", "widgets/tc-half-adder/", "widgets/tc-full-adder/", "widgets/tc-ripple-carry/", "widgets/tc-times-a-trit/", "widgets/tc-long-multiply/", "widgets/tc-ternary-mac/", "widgets/tc-two-bits/", "widgets/tc-five-in-a-byte/", "widgets/tc-trit-word/", "widgets/tc-instruction-word/", "widgets/tc-opcode-map/", "widgets/tc-immediate/", "widgets/tc-ternary-alu/", "widgets/tc-three-way-jump/", "widgets/tc-run-a-program/", "widgets/tc-compare/", "widgets/tc-thirds/", "widgets/tc-sort-three/", "widgets/tc-one-neuron/", "widgets/tc-detector/", "widgets/tc-tiny-layer/", "widgets/nn-relu/", "widgets/nn-sigmoid/", "widgets/nn-tanh/", "widgets/nn-gelu/", "widgets/nn-silu/", "widgets/nn-elu/", "widgets/nn-softmax/", "widgets/nn-embedding/", "widgets/nn-dropout/", "widgets/nn-conv/", "widgets/nn-maxpool/", "widgets/nn-batchnorm/", "widgets/nn-mse/", "widgets/nn-bce/", "widgets/nn-huber/", "widgets/nn-sgd/", "widgets/nn-rmsprop/", "widgets/nn-adam/", "widgets/nn-backprop/", "widgets/nn-xor/", "widgets/nn-lamb/", "widgets/nn-rnn/", "widgets/nn-lstm/", "widgets/nn-attention/", "widgets/nn-positions/", "widgets/nn-encoder/", "widgets/nn-ppo/", "widgets/hive-shape/", "widgets/hive-boundary/", "widgets/hive-task-filter/", "widgets/hive-aging/", "widgets/hive-rank/", "widgets/hive-review-first/", "widgets/hive-lifecycle/", "widgets/hive-ship/", "widgets/hive-drain/", "widgets/hive-reviewers/", "widgets/hive-revisit/", "widgets/hive-gate/", "widgets/hive-jam/", "widgets/hive-jam-action/", "widgets/hive-master-red/", "widgets/hive-key-error/", "widgets/hive-key-rest/", "widgets/hive-next-key/", "widgets/hive-credit/", "widgets/hive-price/", "widgets/hive-burn/", "widgets/hive-called/", "widgets/hive-chain/", "widgets/hive-cooldown/", "widgets/hive-night/", "widgets/hive-column/", "widgets/hive-cell/", "wars", "term/tri-game-tick/", "term/tri-game-vault/", "term/perf2-knockouts/", "widgets/race-the-bee/", "widgets/gatle/", "term/tri-blog-list/", "term/tri-game-selftest/"]; -pub const WIDGET_TITLES : [306]str = ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "WARS: agent configurations compared on real GitHub issues", "", "", "", "", "", "", ""]; -pub const WIDGET_LINES : [306]str = ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "One issue, one pinned commit, the same tools and gates; only the decision layer changes, and a missing run stays unknown.", "", "", "", "", "", "", ""]; +pub const WIDGET_COUNT : u16 = 307; +pub const WIDGET_IDS : [307]str = ["x7-board", "tri-x7-fasm", "tri-x7-mutate", "perf2-loop", "tri-fpga-rgmii", "tri-fpga-jtag", "tri-fpga-pins", "devkit-flow", "play-verilog", "bit-diff", "build-receipt", "cost-curves", "gf16-calc", "idcode", "lut-explain", "pin-map", "placement-map", "resource-bars", "slack-waterfall", "test-waves", "synth-smells", "bit-autopsy", "fasm-skyline", "vcd-wrapped", "fits-on", "stat-card", "lut-depth", "fsm-sketch", "lut-treemap", "t27-cell", "t27-vs-nvfp4", "uart-bucket", "tri-fpga-specs", "tri-fpga-tools", "tri-fpga-wire", "tri-fpga-batch", "tri-fpga-status", "tri-fpga-tmpcheck", "tri-fpga-keycheck", "tri-fpga-selftest", "tri-x7-refs", "tri-x7-audit", "t27c-clock-domain", "t27c-clocks", "t27c-wukong-v1", "t27c-cts", "t27c-mmcm", "t27c-mmcm-mutate", "t27c-timing", "t27c-reset-sync", "t27c-reset-sync-gen", "t27c-mtbf", "t27c-clock-domain-gen", "t27c-fifo", "t27c-fifo-mutate", "t27c-fifo-flags", "t27c-emitter-xdc", "t27c-fpga-rxcap", "t27-tri-competitors", "t27-tri-discard", "tri-fpga-txhold", "tri-fpga-rxcap", "tri-fpga-rxer", "tri-fpga-steps", "tri-fpga-ioclients", "tri-fpga-claim", "tri-fpga-release", "tri-fpga-next", "t27c-memory", "t27c-spi-tb", "t27c-check-uart", "t27c-check-spi", "t27c-check-apb", "t27c-check-axi4", "t27c-check-bridge", "t27c-check-memory", "t27c-verilog-uart", "t27c-verilog-spi", "t27c-verilog-apb", "t27c-verilog-axi4", "t27c-verilog-bridge", "t27c-verilog-top", "t27c-verilog-uart-tb", "t27c-verilog-apb-tb", "t27c-verilog-axi-tb", "t27c-verilog-mem-tb", "t27c-verilog-integration-tb", "t27c-verilog-top-tb", "t27c-verilog-spi-tb", "t27c-hir-uart", "t27c-hir-apb", "t27c-hir-axi4", "t27c-eth-crc", "t27c-rgmii", "jtag-verdict", "line-bounce", "eye-isi", "ecc-secded", "carry-chain", "prefix-adder", "csa-tree", "shift-add", "booth-radix4", "dsp-fit", "q-format", "round-sat", "sqnr", "cordic", "cordic-vector", "sine-table", "alias-fold", "nco", "dft-bin", "fir-response", "fir-design", "fir-cost", "decimator", "cic-growth", "polyphase", "fft-butterfly", "bit-reverse", "fft-scaling", "barker-corr", "fir-fit", "fir-on-board", "play-hello-world", "play-rust", "play-js", "t27c-hello-world", "t27-tri-misread", "test-touch", "t27c-stages", "t27c-e8m0", "play-e8m0", "t27c-ocp-mx", "play-gfternary", "t27c-gfternary", "play-golden-sieve", "t27c-golden-sieve", "play-tnf17", "t27c-tnf17", "t27c-activation-quantizer", "t27c-bitnet-majority", "t27c-bitnet-neuron-nchunk", "t27c-comb-ternary-dot", "t27c-stream-ternary-mac", "t27c-bitnet-mlp", "t27c-gft-smul", "t27c-gft-sadd", "t27c-gft-signed-mac", "t27c-gft-relu", "t27c-gft-exp2", "t27c-gft-argmax4", "t27c-gft-nll", "t27c-gft-sgd-step", "t27c-gft-xornet", "basics-what-a-spec-is", "basics-the-module-line", "basics-comments-and-prose", "basics-constants", "basics-whole-numbers", "basics-true-false-and-text", "basics-arrays", "basics-trits", "basics-expressions", "basics-a-test-block", "basics-many-tests", "basics-functions", "basics-local-names", "basics-if-and-else", "basics-loops", "basics-pub-or-private", "basics-structs", "basics-enums", "basics-use-other-modules", "basics-invariants", "basics-gen-ts", "basics-seven-backends", "basics-stages-of-t27c", "basics-tri-commands", "basics-reading-errors", "basics-a-small-program", "basics-where-next", "golden-split", "golden-phi-ratio", "golden-lucas", "golden-split-optimality", "golden-radix-economy", "golden-phi-in-gf16", "golden-gf4", "golden-gf6", "golden-gf8", "golden-gf10", "golden-gf12", "golden-gf14", "golden-gf16", "golden-dot-two", "golden-gf24", "golden-gf32", "golden-gf48", "golden-gf64", "golden-gf96", "golden-gf128", "golden-gf256", "golden-gf512", "golden-gf1024", "golden-gft8", "golden-gft16", "golden-gft32", "golden-decode", "t27-tri-vectors", "t27-tri-census", "t27-tri-seals", "t27-tri-prose", "t27-tri-lean", "tri-selftest", "play-terminal-gates", "tc-why-three", "tc-balanced-count", "tc-flip-and-cut", "tc-kleene-gates", "tc-consensus-any", "tc-sum-and-carry", "tc-half-adder", "tc-full-adder", "tc-ripple-carry", "tc-times-a-trit", "tc-long-multiply", "tc-ternary-mac", "tc-two-bits", "tc-five-in-a-byte", "tc-trit-word", "tc-instruction-word", "tc-opcode-map", "tc-immediate", "tc-ternary-alu", "tc-three-way-jump", "tc-run-a-program", "tc-compare", "tc-thirds", "tc-sort-three", "tc-one-neuron", "tc-detector", "tc-tiny-layer", "nn-relu", "nn-sigmoid", "nn-tanh", "nn-gelu", "nn-silu", "nn-elu", "nn-softmax", "nn-embedding", "nn-dropout", "nn-conv", "nn-maxpool", "nn-batchnorm", "nn-mse", "nn-bce", "nn-huber", "nn-sgd", "nn-rmsprop", "nn-adam", "nn-backprop", "nn-xor", "nn-lamb", "nn-rnn", "nn-lstm", "nn-attention", "nn-positions", "nn-encoder", "nn-ppo", "hive-shape", "hive-boundary", "hive-task-filter", "hive-aging", "hive-rank", "hive-review-first", "hive-lifecycle", "hive-ship", "hive-drain", "hive-reviewers", "hive-revisit", "hive-gate", "hive-jam", "hive-jam-action", "hive-master-red", "hive-key-error", "hive-key-rest", "hive-next-key", "hive-credit", "hive-price", "hive-burn", "hive-called", "hive-chain", "hive-cooldown", "hive-night", "hive-column", "hive-cell", "course-deck", "wars", "tri-game-tick", "tri-game-vault", "perf2-knockouts", "race-the-bee", "gatle", "tri-blog-list", "tri-game-selftest"]; +pub const WIDGET_KINDS : [307]str = ["cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "player", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "player", "player", "player", "cast", "cast", "tool", "tool", "cast", "player", "cast", "player", "cast", "player", "cast", "player", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "cast", "cast", "cast", "cast", "cast", "cast", "cast", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tool", "tab", "cast", "cast", "cast", "tool", "tool", "cast", "cast"]; +pub const WIDGET_CATEGORIES : [307]str = ["fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "fpga", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "compiler", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game", "game"]; +pub const WIDGET_PAGES : [307]str = ["term/x7-board/", "term/tri-x7-fasm/", "term/tri-x7-mutate/", "term/perf2-loop/", "term/tri-fpga-rgmii/", "term/tri-fpga-jtag/", "term/tri-fpga-pins/", "term/devkit-flow/", "play/hello-world/verilog/", "widgets/bit-diff/", "widgets/build-receipt/", "widgets/cost-curves/", "widgets/gf16-calc/", "widgets/idcode/", "widgets/lut-explain/", "widgets/pin-map/", "widgets/placement-map/", "widgets/resource-bars/", "widgets/slack-waterfall/", "widgets/test-waves/", "widgets/synth-smells/", "widgets/bit-autopsy/", "widgets/fasm-skyline/", "widgets/vcd-wrapped/", "widgets/fits-on/", "widgets/stat-card/", "widgets/lut-depth/", "widgets/fsm-sketch/", "widgets/lut-treemap/", "widgets/t27-cell/", "widgets/t27-vs-nvfp4/", "widgets/uart-bucket/", "term/tri-fpga-specs/", "term/tri-fpga-tools/", "term/tri-fpga-wire/", "term/tri-fpga-batch/", "term/tri-fpga-status/", "term/tri-fpga-tmpcheck/", "term/tri-fpga-keycheck/", "term/tri-fpga-selftest/", "term/tri-x7-refs/", "term/tri-x7-audit/", "term/t27c-clock-domain/", "term/t27c-clocks/", "term/t27c-wukong-v1/", "term/t27c-cts/", "term/t27c-mmcm/", "term/t27c-mmcm-mutate/", "term/t27c-timing/", "term/t27c-reset-sync/", "term/t27c-reset-sync-gen/", "term/t27c-mtbf/", "term/t27c-clock-domain-gen/", "term/t27c-fifo/", "term/t27c-fifo-mutate/", "term/t27c-fifo-flags/", "term/t27c-emitter-xdc/", "term/t27c-fpga-rxcap/", "term/t27-tri-competitors/", "term/t27-tri-discard/", "term/tri-fpga-txhold/", "term/tri-fpga-rxcap/", "term/tri-fpga-rxer/", "term/tri-fpga-steps/", "term/tri-fpga-ioclients/", "term/tri-fpga-claim/", "term/tri-fpga-release/", "term/tri-fpga-next/", "term/t27c-memory/", "term/t27c-spi-tb/", "term/t27c-check-uart/", "term/t27c-check-spi/", "term/t27c-check-apb/", "term/t27c-check-axi4/", "term/t27c-check-bridge/", "term/t27c-check-memory/", "term/t27c-verilog-uart/", "term/t27c-verilog-spi/", "term/t27c-verilog-apb/", "term/t27c-verilog-axi4/", "term/t27c-verilog-bridge/", "term/t27c-verilog-top/", "term/t27c-verilog-uart-tb/", "term/t27c-verilog-apb-tb/", "term/t27c-verilog-axi-tb/", "term/t27c-verilog-mem-tb/", "term/t27c-verilog-integration-tb/", "term/t27c-verilog-top-tb/", "term/t27c-verilog-spi-tb/", "term/t27c-hir-uart/", "term/t27c-hir-apb/", "term/t27c-hir-axi4/", "term/t27c-eth-crc/", "term/t27c-rgmii/", "widgets/jtag-verdict/", "widgets/line-bounce/", "widgets/eye-isi/", "widgets/ecc-secded/", "widgets/carry-chain/", "widgets/prefix-adder/", "widgets/csa-tree/", "widgets/shift-add/", "widgets/booth-radix4/", "widgets/dsp-fit/", "widgets/q-format/", "widgets/round-sat/", "widgets/sqnr/", "widgets/cordic/", "widgets/cordic-vector/", "widgets/sine-table/", "widgets/alias-fold/", "widgets/nco/", "widgets/dft-bin/", "widgets/fir-response/", "widgets/fir-design/", "widgets/fir-cost/", "widgets/decimator/", "widgets/cic-growth/", "widgets/polyphase/", "widgets/fft-butterfly/", "widgets/bit-reverse/", "widgets/fft-scaling/", "widgets/barker-corr/", "widgets/fir-fit/", "widgets/fir-on-board/", "play/hello-world/", "play/hello-world/rust/", "play/hello-world/js/", "term/t27c-hello-world/", "term/t27-tri-misread/", "widgets/test-touch/", "widgets/t27c-stages/", "term/t27c-e8m0/", "play/e8m0/", "term/t27c-ocp-mx/", "play/gfternary/", "term/t27c-gfternary/", "play/golden-sieve/", "term/t27c-golden-sieve/", "play/tnf17/", "term/t27c-tnf17/", "term/t27c-activation-quantizer/", "term/t27c-bitnet-majority/", "term/t27c-bitnet-neuron-nchunk/", "term/t27c-comb-ternary-dot/", "term/t27c-stream-ternary-mac/", "term/t27c-bitnet-mlp/", "term/t27c-gft-smul/", "term/t27c-gft-sadd/", "term/t27c-gft-signed-mac/", "term/t27c-gft-relu/", "term/t27c-gft-exp2/", "term/t27c-gft-argmax4/", "term/t27c-gft-nll/", "term/t27c-gft-sgd-step/", "term/t27c-gft-xornet/", "widgets/basics-what-a-spec-is/", "widgets/basics-the-module-line/", "widgets/basics-comments-and-prose/", "widgets/basics-constants/", "widgets/basics-whole-numbers/", "widgets/basics-true-false-and-text/", "widgets/basics-arrays/", "widgets/basics-trits/", "widgets/basics-expressions/", "widgets/basics-a-test-block/", "widgets/basics-many-tests/", "widgets/basics-functions/", "widgets/basics-local-names/", "widgets/basics-if-and-else/", "widgets/basics-loops/", "widgets/basics-pub-or-private/", "widgets/basics-structs/", "widgets/basics-enums/", "widgets/basics-use-other-modules/", "widgets/basics-invariants/", "widgets/basics-gen-ts/", "widgets/basics-seven-backends/", "widgets/basics-stages-of-t27c/", "widgets/basics-tri-commands/", "widgets/basics-reading-errors/", "widgets/basics-a-small-program/", "widgets/basics-where-next/", "widgets/golden-split/", "widgets/golden-phi-ratio/", "widgets/golden-lucas/", "widgets/golden-split-optimality/", "widgets/golden-radix-economy/", "widgets/golden-phi-in-gf16/", "widgets/golden-gf4/", "widgets/golden-gf6/", "widgets/golden-gf8/", "widgets/golden-gf10/", "widgets/golden-gf12/", "widgets/golden-gf14/", "widgets/golden-gf16/", "widgets/golden-dot-two/", "widgets/golden-gf24/", "widgets/golden-gf32/", "widgets/golden-gf48/", "widgets/golden-gf64/", "widgets/golden-gf96/", "widgets/golden-gf128/", "widgets/golden-gf256/", "widgets/golden-gf512/", "widgets/golden-gf1024/", "widgets/golden-gft8/", "widgets/golden-gft16/", "widgets/golden-gft32/", "widgets/golden-decode/", "term/t27-tri-vectors/", "term/t27-tri-census/", "term/t27-tri-seals/", "term/t27-tri-prose/", "term/t27-tri-lean/", "term/tri-selftest/", "term/play-terminal-gates/", "widgets/tc-why-three/", "widgets/tc-balanced-count/", "widgets/tc-flip-and-cut/", "widgets/tc-kleene-gates/", "widgets/tc-consensus-any/", "widgets/tc-sum-and-carry/", "widgets/tc-half-adder/", "widgets/tc-full-adder/", "widgets/tc-ripple-carry/", "widgets/tc-times-a-trit/", "widgets/tc-long-multiply/", "widgets/tc-ternary-mac/", "widgets/tc-two-bits/", "widgets/tc-five-in-a-byte/", "widgets/tc-trit-word/", "widgets/tc-instruction-word/", "widgets/tc-opcode-map/", "widgets/tc-immediate/", "widgets/tc-ternary-alu/", "widgets/tc-three-way-jump/", "widgets/tc-run-a-program/", "widgets/tc-compare/", "widgets/tc-thirds/", "widgets/tc-sort-three/", "widgets/tc-one-neuron/", "widgets/tc-detector/", "widgets/tc-tiny-layer/", "widgets/nn-relu/", "widgets/nn-sigmoid/", "widgets/nn-tanh/", "widgets/nn-gelu/", "widgets/nn-silu/", "widgets/nn-elu/", "widgets/nn-softmax/", "widgets/nn-embedding/", "widgets/nn-dropout/", "widgets/nn-conv/", "widgets/nn-maxpool/", "widgets/nn-batchnorm/", "widgets/nn-mse/", "widgets/nn-bce/", "widgets/nn-huber/", "widgets/nn-sgd/", "widgets/nn-rmsprop/", "widgets/nn-adam/", "widgets/nn-backprop/", "widgets/nn-xor/", "widgets/nn-lamb/", "widgets/nn-rnn/", "widgets/nn-lstm/", "widgets/nn-attention/", "widgets/nn-positions/", "widgets/nn-encoder/", "widgets/nn-ppo/", "widgets/hive-shape/", "widgets/hive-boundary/", "widgets/hive-task-filter/", "widgets/hive-aging/", "widgets/hive-rank/", "widgets/hive-review-first/", "widgets/hive-lifecycle/", "widgets/hive-ship/", "widgets/hive-drain/", "widgets/hive-reviewers/", "widgets/hive-revisit/", "widgets/hive-gate/", "widgets/hive-jam/", "widgets/hive-jam-action/", "widgets/hive-master-red/", "widgets/hive-key-error/", "widgets/hive-key-rest/", "widgets/hive-next-key/", "widgets/hive-credit/", "widgets/hive-price/", "widgets/hive-burn/", "widgets/hive-called/", "widgets/hive-chain/", "widgets/hive-cooldown/", "widgets/hive-night/", "widgets/hive-column/", "widgets/hive-cell/", "widgets/course-deck/", "wars", "term/tri-game-tick/", "term/tri-game-vault/", "term/perf2-knockouts/", "widgets/race-the-bee/", "widgets/gatle/", "term/tri-blog-list/", "term/tri-game-selftest/"]; +pub const WIDGET_TITLES : [307]str = ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "WARS: agent configurations compared on real GitHub issues", "", "", "", "", "", "", ""]; +pub const WIDGET_LINES : [307]str = ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "One issue, one pinned commit, the same tools and gates; only the decision layer changes, and a missing run stays unknown.", "", "", "", "", "", "", ""]; ; Why a person would pass this one on: the reason the widget is in the gallery at all. -pub const WIDGET_HOOKS : [306]str = ["The bitstream is byte-identical to openXC7's and runs on a real board: the claim most FPGA people doubt, shown.", "A Xilinx 7-series bitstream assembled with no Vivado anywhere in the path.", "Plant a bug in the bitstream path and watch the tests catch it: mutation testing for hardware.", "Place and route to a loaded bitstream, with the clock on screen.", "RGMII hold margins read from nextpnr's own SDF, not from a datasheet.", "The cable asks which chip is there and the chip answers with its IDCODE.", "Before an edit to a Verilog file: every spec and generator it would touch.", "The whole FPGA flow, one layer per line, from spec to board.", "A spec turned into Verilog inside a post, with the RTL read the way a hardware engineer reads it.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "17 of 17 conformance specs compile, their test blocks pass, and no generated file has drifted.", "14 of 14 bench tools pass their own self-tests in one sweep: decode 18/18, repin 17/17, firelog 10/10, tmpcheck 9/9, stamps 9/9, keep 9/9.", "Requested 115,200 puts 115,385 on the wire (+0.16 %), 921,600 puts 923,077, and 3,000,000 is exact.", "26 checks, no board, no RTL: every receipt returns, 11 loss and fault cases recover, and a lie stops the run.", "One command reads the bench: cables, locks, and the last board runs: three x7-board runs PASS 51840/51840.", "112 files under /tmp pinned by sha256 in specs: every one has a kept copy, 0 lost, 0 unlocated.", "84 board and model logs scanned for the TRI-NET key: 0 hits, 0 logs of 1 MB or more.", "16 spec-named scripts run their own --self-test, 0 bad; 8 without the flag are listed, not skipped silently.", "The part table in far.t27 matches prjxray-db part.json, all 6 reference bitstreams present, bitwalk reads all 6 in 84.4 ms.", "One command re-runs every sweep: CRC 12/12, ECC 32520/32520 frames, 82/82 pins, 4224/4224 segbits, gold 5/5. audit: CLEAN.", "The CDC spec through the real compiler: 12 tests pass natively and the header says what the model does and does not claim.", "The tri clocks card as a spec: constants a tool page reads, and a native test-report that says so plainly -- 0 tests, because it is not a test suite.", "The board itself as a spec: 15 tests pass natively and the part line names the xc7a200tfgg676 the Wukong carries.", "Clock-tree synthesis in numbers: 15 tests pass natively, and the header pins the Artix-7 teaching delays the tree arithmetic uses.", "The MMCM model through the real compiler: VCO window, M/D/O ranges, fractional multiply in eighths, the 1/56 phase step, 16 tests natively.", "Widen the VCO window with one sed and exactly one test objects -- the rejection test that names the 500 MHz config it calls out.", "Static timing as arithmetic: 25 tests pass natively on arcs, slack and Fmax, with the Artix-7 teaching delays in the header.", "The three reset kinds through the real compiler: async assert with sync release through 2 to 4 flops, and the racy async release, 16 tests natively.", "What the compiler emits for the reset pipe: t27c gen prints the Zig, one struct copy per clock, and wc -l counts it.", "Metastability MTBF without floats: the WP323 form in Q10 log2, one flop negative slack, two flops astronomical, 15 tests natively.", "The CDC model as Zig: t27c gen prints what it compiled and wc -l says how many lines of code the model is.", "The FIFO stdlib through the real compiler: 18 tests pass natively and 6 invariants are proved comptime.", "Move a pointer by 3 instead of 1 and every test still passes: the suite asserts fill and flags, never pointer values.", "Flip one flag assignment and a single test objects: the guard that keeps the FIFO honest.", "The pins-to-XDC emitter spec parsed by the real compiler, and the create_clock lines it exists to write.", "The fpga-rxcap tool card as a spec: constants for a tool page, and a native run that says 0 tests and why.", "168 records: 14 papers entered twice, 141 cite no score, 144 state zero at pass@1.", "67 specs lose 23,578 tokens to parser recovery, each held at its pinned bound.", "Smallest hold 3445 ps on TXD1 against a 1000 ps bench; each TX pin setup and hold from the routed SDF.", "Per-bit setup and hold of an async RX nibble against its RXC edge, from the routed SDF: one nibble changes 2387 to 2486 ps apart, so a binary counter tears where a gray one cannot.", "RX_ER pulses injected at exact nibble positions of a ping -- preamble, mid-frame, IP header -- and the frame state each pulse leaves behind, RTL vs model.", "The Ethernet bring-up plan on the bench: pre-registered steps, logged exits, what ran and what did not.", "The registered IO clients on the bench, read live: names, claims and what each declares it owns.", "The bench claim in action: one client takes the hardware lock and the tool reports who holds it.", "The bench lock given back: the client gives up its claim and the bench reports itself free.", "The next queued step on the bench, read live from the run state.", "The memory map spec through the real compiler: 15 tests pass natively and 6 invariants are proved comptime.", "The SPI testbench through the real compiler: 7 tests pass natively, driving the modes and checking the captures.", "t27c check on the UART spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the SPI spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the APB bridge spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the AXI4 spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the bus bridge spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the memory spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "The UART spec lowered to synthesizable Verilog: the TRINITY banner, the module port list and the datapath as wires.", "The SPI spec lowered to synthesizable Verilog: the TRINITY banner, the module port list and the datapath as wires.", "The APB bridge spec lowered to synthesizable Verilog: port list, PSEL and PENABLE wiring, the address decode.", "The AXI4 spec lowered to synthesizable Verilog: the five channels' wiring and handshakes as generated wires.", "The bus bridge spec lowered to synthesizable Verilog: both sides of the crossing as generated wires.", "The whole design in one spec lowered to synthesizable Verilog: clocks, resets and bus wiring as the compiler emits them.", "The UART testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The APB bridge testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The AXI4 testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The memory testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The integration testbench spec lowered to Verilog: every bus of the design in one bench.", "The top-level testbench spec lowered to Verilog: the whole design under one bench.", "The SPI testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The UART spec lowered to hardware IR: the compiler's own view of the wires and state before Verilog exists.", "The APB bridge spec lowered to hardware IR: PSEL, PENABLE and the decode as the compiler structures them.", "The AXI4 spec lowered to hardware IR: the five channels and their handshakes as the compiler structures them.", "The Ethernet FCS spec through the real compiler: 8 tests pass natively -- the table derived from one bit step, the 0xCBF43926 check value, the 0xDEBB20E3 receiver residue.", "The RGMII spec through the real compiler: 7 tests pass natively and 1 invariant is proved comptime -- the 8 ns gigabit period, a nibble on both edges, the 78 ps tap ladder.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "The t27 compiler running as WebAssembly in a post: compile, test, seven backends.", "The same spec as Rust, printed by a terminal in the page.", "The only backend that runs in the browser: generate the module, then run it.", "t27c on hello_world.t27, on a real machine, every byte as printed.", "Code that compiles and is wrong: the tool that finds it.", "", "", "The OCP MX scale byte as a spec: 2^(e-127), code 255 is NaN, 18 tests and 9 comptime invariants, compiled on a real machine.", "The same scale byte compiled in your browser: seven backends, the spec's tests run in the page, and every skip says why.", "One outlier sets the scale for 32 weights: MXFP4 flushes 23 of them to zero, MXFP8 E4M3 none. 49 tests pass; a planted bug fails one.", "Ternary weights scaled by phi, compiled in your browser: codes 00, 01, 10, and the fourth code folded to zero.", "13 of 13 tests pass natively, and the report says 8 of them executed no assert; a planted bug fails exactly one.", "Five measured rules for a ternary weight alphabet, and the one formula that passes all five, run in your browser.", "One more trit and the spec does not compile at all: BLOCKED, not failed, because no test ever ran.", "A 17-bit float whose exponent is four balanced trits, 3^4 = 81 values, compiled in your browser.", "34 tests pass natively, none vacuous; swap one XOR for OR and only the test that negates twice fails.", "A neuron's sum squeezed back to one trit: 7 tests pass natively, and turning one > into >= fails only the boundary test.", "One ternary neuron, two functions picked by its weights: 12 tests pass natively, and one weight moved from P to Z fails exactly one.", "A neuron wider than 27 inputs, summed chunk by chunk: 11 tests pass natively, and a loop that stops after one chunk fails exactly one.", "A 27-lane ternary dot product as pure wires: 4 tests pass natively, and one wrong sign in tmul fails exactly one.", "The same dot product added into a register on every clock: 4 tests pass natively, and a lane mask short one bit fails exactly one.", "A whole small ternary network, 3 neurons then 2: 4 tests pass natively, and a trit packed one bit low fails exactly one.", "A signed multiply: 3 tests pass natively, none vacuous, and a sign stuck at 0 fails exactly one, m2.", "A signed add: 3 tests pass natively, and adding where opposite signs must subtract fails exactly one, a2.", "Two signed products summed: 4 tests pass natively, and OR in place of the sign XOR fails exactly one, pp.", "A ReLU: 4 tests pass natively, and letting negative inputs through fails only negz, the one test with a negative input.", "2^x for a softmax: 4 tests pass natively, and dropping the minus sign of k fails exactly one, em1.", "argmax by comparing bits alone: 4 tests pass natively, and >= in place of > fails exactly one, tie_low.", "A loss in bits: 3 tests pass natively, and a zero with the sign bit set fails exactly one, perfect.", "One SGD step: 3 tests pass natively, and g times g in place of eta times g fails exactly one, ascend.", "A 2-layer ReLU net for XOR: 4 tests pass natively, and one relu removed fails exactly one, x00.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "34 vector files, 512 cases: 2 files executed, 8 debt, 24 prose-only; 19% carry data.", "Four census populations recounted another way all agree; three are named as uncheckable.", "31 of 1,428 seals record no output (16 specs); 3 of those are missing from the debt ledger.", "11 specs refused at parse, 0 blocked only by prose, 23 broken on purpose as fixtures.", "12 Lean files, 15,553 lines and 4 sorry, are reached by no build root: nothing compiles them.", "tri, railway, python3 and the loop directory: each present or not, in one call.", "The terminal for seven t27 backends: every command run on hello_world. 21 pass, 0 fail.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "Pick a lane and see whether the TRI decision layer beats the baseline on the same issue.", "One tick of the Queen's loop: an anomaly scan that reports only what changed.", "The loop's skills checked against snapshots before an agent may use them.", "Three performance bits, and one knockout bitstream per bit to prove each one matters.", "", "", "73 published posts with date, language and revision, newest first.", "6 of 6 self-tests hold: anomalies, blog_drift, lessons, site_gate, tick, vault."]; +pub const WIDGET_HOOKS : [307]str = ["The bitstream is byte-identical to openXC7's and runs on a real board: the claim most FPGA people doubt, shown.", "A Xilinx 7-series bitstream assembled with no Vivado anywhere in the path.", "Plant a bug in the bitstream path and watch the tests catch it: mutation testing for hardware.", "Place and route to a loaded bitstream, with the clock on screen.", "RGMII hold margins read from nextpnr's own SDF, not from a datasheet.", "The cable asks which chip is there and the chip answers with its IDCODE.", "Before an edit to a Verilog file: every spec and generator it would touch.", "The whole FPGA flow, one layer per line, from spec to board.", "A spec turned into Verilog inside a post, with the RTL read the way a hardware engineer reads it.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "17 of 17 conformance specs compile, their test blocks pass, and no generated file has drifted.", "14 of 14 bench tools pass their own self-tests in one sweep: decode 18/18, repin 17/17, firelog 10/10, tmpcheck 9/9, stamps 9/9, keep 9/9.", "Requested 115,200 puts 115,385 on the wire (+0.16 %), 921,600 puts 923,077, and 3,000,000 is exact.", "26 checks, no board, no RTL: every receipt returns, 11 loss and fault cases recover, and a lie stops the run.", "One command reads the bench: cables, locks, and the last board runs: three x7-board runs PASS 51840/51840.", "112 files under /tmp pinned by sha256 in specs: every one has a kept copy, 0 lost, 0 unlocated.", "84 board and model logs scanned for the TRI-NET key: 0 hits, 0 logs of 1 MB or more.", "16 spec-named scripts run their own --self-test, 0 bad; 8 without the flag are listed, not skipped silently.", "The part table in far.t27 matches prjxray-db part.json, all 6 reference bitstreams present, bitwalk reads all 6 in 84.4 ms.", "One command re-runs every sweep: CRC 12/12, ECC 32520/32520 frames, 82/82 pins, 4224/4224 segbits, gold 5/5. audit: CLEAN.", "The CDC spec through the real compiler: 12 tests pass natively and the header says what the model does and does not claim.", "The tri clocks card as a spec: constants a tool page reads, and a native test-report that says so plainly -- 0 tests, because it is not a test suite.", "The board itself as a spec: 15 tests pass natively and the part line names the xc7a200tfgg676 the Wukong carries.", "Clock-tree synthesis in numbers: 15 tests pass natively, and the header pins the Artix-7 teaching delays the tree arithmetic uses.", "The MMCM model through the real compiler: VCO window, M/D/O ranges, fractional multiply in eighths, the 1/56 phase step, 16 tests natively.", "Widen the VCO window with one sed and exactly one test objects -- the rejection test that names the 500 MHz config it calls out.", "Static timing as arithmetic: 25 tests pass natively on arcs, slack and Fmax, with the Artix-7 teaching delays in the header.", "The three reset kinds through the real compiler: async assert with sync release through 2 to 4 flops, and the racy async release, 16 tests natively.", "What the compiler emits for the reset pipe: t27c gen prints the Zig, one struct copy per clock, and wc -l counts it.", "Metastability MTBF without floats: the WP323 form in Q10 log2, one flop negative slack, two flops astronomical, 15 tests natively.", "The CDC model as Zig: t27c gen prints what it compiled and wc -l says how many lines of code the model is.", "The FIFO stdlib through the real compiler: 18 tests pass natively and 6 invariants are proved comptime.", "Move a pointer by 3 instead of 1 and every test still passes: the suite asserts fill and flags, never pointer values.", "Flip one flag assignment and a single test objects: the guard that keeps the FIFO honest.", "The pins-to-XDC emitter spec parsed by the real compiler, and the create_clock lines it exists to write.", "The fpga-rxcap tool card as a spec: constants for a tool page, and a native run that says 0 tests and why.", "168 records: 14 papers entered twice, 141 cite no score, 144 state zero at pass@1.", "67 specs lose 23,578 tokens to parser recovery, each held at its pinned bound.", "Smallest hold 3445 ps on TXD1 against a 1000 ps bench; each TX pin setup and hold from the routed SDF.", "Per-bit setup and hold of an async RX nibble against its RXC edge, from the routed SDF: one nibble changes 2387 to 2486 ps apart, so a binary counter tears where a gray one cannot.", "RX_ER pulses injected at exact nibble positions of a ping -- preamble, mid-frame, IP header -- and the frame state each pulse leaves behind, RTL vs model.", "The Ethernet bring-up plan on the bench: pre-registered steps, logged exits, what ran and what did not.", "The registered IO clients on the bench, read live: names, claims and what each declares it owns.", "The bench claim in action: one client takes the hardware lock and the tool reports who holds it.", "The bench lock given back: the client gives up its claim and the bench reports itself free.", "The next queued step on the bench, read live from the run state.", "The memory map spec through the real compiler: 15 tests pass natively and 6 invariants are proved comptime.", "The SPI testbench through the real compiler: 7 tests pass natively, driving the modes and checking the captures.", "t27c check on the UART spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the SPI spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the APB bridge spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the AXI4 spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the bus bridge spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "t27c check on the memory spec: 0 errors, 0 warnings -- the first bar every lesson's spec clears.", "The UART spec lowered to synthesizable Verilog: the TRINITY banner, the module port list and the datapath as wires.", "The SPI spec lowered to synthesizable Verilog: the TRINITY banner, the module port list and the datapath as wires.", "The APB bridge spec lowered to synthesizable Verilog: port list, PSEL and PENABLE wiring, the address decode.", "The AXI4 spec lowered to synthesizable Verilog: the five channels' wiring and handshakes as generated wires.", "The bus bridge spec lowered to synthesizable Verilog: both sides of the crossing as generated wires.", "The whole design in one spec lowered to synthesizable Verilog: clocks, resets and bus wiring as the compiler emits them.", "The UART testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The APB bridge testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The AXI4 testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The memory testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The integration testbench spec lowered to Verilog: every bus of the design in one bench.", "The top-level testbench spec lowered to Verilog: the whole design under one bench.", "The SPI testbench spec lowered to Verilog: what a bench looks like when the compiler emits it.", "The UART spec lowered to hardware IR: the compiler's own view of the wires and state before Verilog exists.", "The APB bridge spec lowered to hardware IR: PSEL, PENABLE and the decode as the compiler structures them.", "The AXI4 spec lowered to hardware IR: the five channels and their handshakes as the compiler structures them.", "The Ethernet FCS spec through the real compiler: 8 tests pass natively -- the table derived from one bit step, the 0xCBF43926 check value, the 0xDEBB20E3 receiver residue.", "The RGMII spec through the real compiler: 7 tests pass natively and 1 invariant is proved comptime -- the 8 ns gigabit period, a nibble on both edges, the 78 ps tap ladder.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "The t27 compiler running as WebAssembly in a post: compile, test, seven backends.", "The same spec as Rust, printed by a terminal in the page.", "The only backend that runs in the browser: generate the module, then run it.", "t27c on hello_world.t27, on a real machine, every byte as printed.", "Code that compiles and is wrong: the tool that finds it.", "", "", "The OCP MX scale byte as a spec: 2^(e-127), code 255 is NaN, 18 tests and 9 comptime invariants, compiled on a real machine.", "The same scale byte compiled in your browser: seven backends, the spec's tests run in the page, and every skip says why.", "One outlier sets the scale for 32 weights: MXFP4 flushes 23 of them to zero, MXFP8 E4M3 none. 49 tests pass; a planted bug fails one.", "Ternary weights scaled by phi, compiled in your browser: codes 00, 01, 10, and the fourth code folded to zero.", "13 of 13 tests pass natively, and the report says 8 of them executed no assert; a planted bug fails exactly one.", "Five measured rules for a ternary weight alphabet, and the one formula that passes all five, run in your browser.", "One more trit and the spec does not compile at all: BLOCKED, not failed, because no test ever ran.", "A 17-bit float whose exponent is four balanced trits, 3^4 = 81 values, compiled in your browser.", "34 tests pass natively, none vacuous; swap one XOR for OR and only the test that negates twice fails.", "A neuron's sum squeezed back to one trit: 7 tests pass natively, and turning one > into >= fails only the boundary test.", "One ternary neuron, two functions picked by its weights: 12 tests pass natively, and one weight moved from P to Z fails exactly one.", "A neuron wider than 27 inputs, summed chunk by chunk: 11 tests pass natively, and a loop that stops after one chunk fails exactly one.", "A 27-lane ternary dot product as pure wires: 4 tests pass natively, and one wrong sign in tmul fails exactly one.", "The same dot product added into a register on every clock: 4 tests pass natively, and a lane mask short one bit fails exactly one.", "A whole small ternary network, 3 neurons then 2: 4 tests pass natively, and a trit packed one bit low fails exactly one.", "A signed multiply: 3 tests pass natively, none vacuous, and a sign stuck at 0 fails exactly one, m2.", "A signed add: 3 tests pass natively, and adding where opposite signs must subtract fails exactly one, a2.", "Two signed products summed: 4 tests pass natively, and OR in place of the sign XOR fails exactly one, pp.", "A ReLU: 4 tests pass natively, and letting negative inputs through fails only negz, the one test with a negative input.", "2^x for a softmax: 4 tests pass natively, and dropping the minus sign of k fails exactly one, em1.", "argmax by comparing bits alone: 4 tests pass natively, and >= in place of > fails exactly one, tie_low.", "A loss in bits: 3 tests pass natively, and a zero with the sign bit set fails exactly one, perfect.", "One SGD step: 3 tests pass natively, and g times g in place of eta times g fails exactly one, ascend.", "A 2-layer ReLU net for XOR: 4 tests pass natively, and one relu removed fails exactly one, x00.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "34 vector files, 512 cases: 2 files executed, 8 debt, 24 prose-only; 19% carry data.", "Four census populations recounted another way all agree; three are named as uncheckable.", "31 of 1,428 seals record no output (16 specs); 3 of those are missing from the debt ledger.", "11 specs refused at parse, 0 blocked only by prose, 23 broken on purpose as fixtures.", "12 Lean files, 15,553 lines and 4 sorry, are reached by no build root: nothing compiles them.", "tri, railway, python3 and the loop directory: each present or not, in one call.", "The terminal for seven t27 backends: every command run on hello_world. 21 pass, 0 fail.", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "Pick a lane and see whether the TRI decision layer beats the baseline on the same issue.", "One tick of the Queen's loop: an anomaly scan that reports only what changed.", "The loop's skills checked against snapshots before an agent may use them.", "Three performance bits, and one knockout bitstream per bit to prove each one matters.", "", "", "73 published posts with date, language and revision, newest first.", "6 of 6 self-tests hold: anomalies, blog_drift, lessons, site_gate, tick, vault."]; ; --- Ideas: asked for, not built --------------------------------------------------------------- ; From what engineers share today (gh-skyline, Tiny Tapeout renders, Wrapped cards, Gatle-style @@ -119,9 +119,9 @@ test the_fpga_shelf_comes_first_and_opens_on_the_board { } test the_arena_is_a_tab_and_says_its_own_words { - assert WIDGET_IDS[298] == "wars"; - assert WIDGET_KINDS[298] == "tab"; - assert WIDGET_PAGES[298] == "wars"; + assert WIDGET_IDS[299] == "wars"; + assert WIDGET_KINDS[299] == "tab"; + assert WIDGET_PAGES[299] == "wars"; } test the_gallery_posts_nothing { @@ -157,8 +157,8 @@ test the_verification_shelf_is_rehearsals_and_audits { test ideas_are_counted_apart_from_widgets { assert IDEA_COUNT == 6; - assert WIDGET_IDS[303] == "gatle"; - assert WIDGET_COUNT == 306; + assert WIDGET_IDS[304] == "gatle"; + assert WIDGET_COUNT == 307; } test the_ternary_machine_shelf_runs_before_the_arena { @@ -172,9 +172,9 @@ test every_tool_lives_under_widgets_and_keeps_its_words_on_its_page { assert WIDGET_KINDS[9] == "tool"; assert WIDGET_PAGES[9] == "widgets/bit-diff/"; assert WIDGET_HOOKS[9] == ""; - assert WIDGET_KINDS[302] == "tool"; - assert WIDGET_CATEGORIES[302] == "game"; - assert WIDGET_PAGES[302] == "widgets/race-the-bee/"; + assert WIDGET_KINDS[303] == "tool"; + assert WIDGET_CATEGORIES[303] == "game"; + assert WIDGET_PAGES[303] == "widgets/race-the-bee/"; } test the_arithmetic_shelf_closes_the_fpga_bench { @@ -192,7 +192,7 @@ test the_neural_network_shelf_runs_before_the_arena { assert WIDGET_PAGES[244] == "widgets/nn-relu/"; assert WIDGET_IDS[270] == "nn-ppo"; assert WIDGET_CATEGORIES[270] == "compiler"; - assert WIDGET_IDS[298] == "wars"; + assert WIDGET_IDS[299] == "wars"; } test the_hive_shelf_runs_before_the_arena { @@ -201,5 +201,17 @@ test the_hive_shelf_runs_before_the_arena { assert WIDGET_PAGES[271] == "widgets/hive-shape/"; assert WIDGET_IDS[297] == "hive-cell"; assert WIDGET_CATEGORIES[297] == "game"; - assert WIDGET_IDS[298] == "wars"; + assert WIDGET_IDS[299] == "wars"; +} + +; The course deck holds a whole course's lesson widgets, so it closes the course shelves: after the +; last course's last widget (the hive's, on the game shelf), before the arena. +test the_course_deck_closes_the_course_shelves_before_the_arena { + assert WIDGET_IDS[298] == "course-deck"; + assert WIDGET_KINDS[298] == "tool"; + assert WIDGET_CATEGORIES[298] == "game"; + assert WIDGET_PAGES[298] == "widgets/course-deck/"; + assert WIDGET_HOOKS[298] == ""; + assert WIDGET_IDS[297] == "hive-cell"; + assert WIDGET_IDS[299] == "wars"; } From cb598aeb7658ae923e2430ce4fea9ed256316598 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 19 Oct 2026 04:37:54 +0000 Subject: [PATCH 3/5] docs(blog): every course is free now, and each one fits on one page that is also a widget (#1703) The course PR carries its post (specs/policy/course_post.t27): EN body and RU ruBody, registered in index.ts and posts.ts. Its figure is drawn by the compiled step_of of course-access.t27 VERSION 2 (8e535bc9) and VERSION 3 (this branch), rungs 0 to 10. The numbers in it are this branch's measurements (3 live frames at most, layout shift 0, 0.43/0.53 em per character) and the spec's constants. It names what the change does not do. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01ScHVrGSr6zZUdwkdC8DR9k --- ...e-free-and-the-whole-course-on-one-page.ts | 157 ++++++++++++++++++ apps/website/src/data/blog/index.ts | 30 ++++ apps/website/src/data/blog/posts.ts | 2 + 3 files changed, 189 insertions(+) create mode 100644 apps/website/src/data/blog/bodies/every-course-free-and-the-whole-course-on-one-page.ts diff --git a/apps/website/src/data/blog/bodies/every-course-free-and-the-whole-course-on-one-page.ts b/apps/website/src/data/blog/bodies/every-course-free-and-the-whole-course-on-one-page.ts new file mode 100644 index 0000000000..3720029e14 --- /dev/null +++ b/apps/website/src/data/blog/bodies/every-course-free-and-the-whole-course-on-one-page.ts @@ -0,0 +1,157 @@ +import type { Block } from '../types' + +// Every course free (gHashTag/t27 course-access.t27 VERSION 3, t27#10799), the whole course on one +// page and the course deck (trinity#1703). The figure was drawn from the compiled step_of of +// VERSION 2 (trinity 8e535bc9 courseAccess.logic.ts) and VERSION 3 (this PR's), for rungs 0 to 10. + +export const body: Block[] = [ + { + "kind": "p", + "text": "Every course on t27.ai is free now, for every reader, however many he opens. Until today the ladder gave any three courses free and asked for the club from the fourth on. The owner, on 2026-10-19: our task is to grow the language. A course that asks for the club is a reader the language does not get." + }, + { + "kind": "h", + "text": "One function, changed in the spec first" + }, + { + "kind": "p", + "text": "Which course is free is not decided on the site. It is step_of in gHashTag/t27 specs/automation/course-access.t27, and since VERSION 3 (t27#10799) it returns FREE for every rung. The site vendors that spec byte for byte and runs its fn bodies compiled to WebAssembly (courseAccess.logic.ts, spec-sha256 edd87ade). The figure is drawn by those compiled bodies: step_of for the first 11 courses a reader opens, 0 for free and 2 for the club." + }, + { + "kind": "figure", + "svg": "step_of(0..10): v2 and v3 of course-access.t271234567891011v200022222222v300000000000", + "caption": "step_of from the compiled course-access.t27: VERSION 2 (top) gives 0 to the first three courses and 2 (the club) from the fourth; VERSION 3 (bottom) gives 0 to all of them." + }, + { + "kind": "p", + "text": "One trap was left for the hosts, and the spec says so: a reader's browser keeps the step each course was opened on, and stays_open closes a course stored on the club rung when the club ends. So the site no longer reads the stored step. It asks step_of for the course's rung again, and a test with the opposite rule (read the stored step) fails. The lock, the gate and the rouble and TON forms are gone from the course pages." + }, + { + "kind": "h", + "text": "The whole course on one page" + }, + { + "kind": "p", + "text": "Each course now has a page with all 27 lessons on it: the goal, the text, the task and the lesson's own widget, under one link with its own preview card. The basics are at t27.ai/learn/all/, every other course at t27.ai/learn//all/, and the Russian ones under ru/. It is a real page, not a #/ route, so X, Telegram and LinkedIn show the course card and not the home page." + }, + { + "kind": "p", + "text": "27 live widgets would sink a phone, so a widget frame mounts only when its lesson comes within 600 px of the screen, at most 3 are live at once, and a frame more than 2000 px away is taken down. Each frame's height is reserved before it loads. Scrolling the neural networks page in Chromium at 390 px, the count of live frames never went above 3, and the layout shift was 0. On a phone the contents sit under the thumb with a dot per lesson; from 1440 px they stand in a column beside the lessons." + }, + { + "kind": "h", + "text": "A widget of widgets" + }, + { + "kind": "p", + "text": "The same course is also one embeddable widget, the course deck at t27.ai/widgets/course-deck/: nine module tabs, three lesson cards each, every card running its lesson's widget, mounted the same lazy way. One widget serves every course with ?course=; eleven copies would differ only in their data. It sits in the widget gallery before the arena." + }, + { + "kind": "h", + "text": "TRI CLAW at the foot of every course page" + }, + { + "kind": "ul", + "items": [ + "Free with your own key: add an API key (NVIDIA or z.ai today) and the agent runs on it; add more keys any time. The button opens the app's key screen inside Telegram.", + "We do it for you: the club in the bot, which shows the price before you pay.", + "On GitHub: TRI CLAW is also a GitHub App that checks .t27 in pull requests. It is not open to other repositories yet, so the button opens the TRI CLAW post; one constant in the spec switches it to the App's page." + ] + }, + { + "kind": "h", + "text": "The layout is a spec too" + }, + { + "kind": "p", + "text": "Every number of the course screens is in specs/view/course-view.t27 with tests: the column width, the breakpoints, the frame budget, the 44 px finger, the 2 px focus ring, the 4.5:1 contrast floor. The column width was measured, not guessed: an average character of lesson text is 0.43 em in English and 0.53 em in Russian, so a 70 character line is 30.1 em and 37.2 em. A 68ch column would have been 95 characters wide, because a ch is a zero and Outfit's zero is 0.66 em. Text and widget stand side by side from 1150 px; below that the widget comes right after the task it answers." + }, + { + "kind": "h", + "text": "What this does not do" + }, + { + "kind": "ul", + "items": [ + "The key screen the free path opens is added to the app in gHashTag/999-multibots-telegraf at the same time; until it ships, the button opens the bot.", + "The site no longer calls the render's checkout; the club is paid in the bot.", + "A static lesson page still scrolls 25 px sideways on a 390 px phone in Chromium, as it did before this change; what widens it is not found yet." + ] + } +] + +export const ruBody: Block[] = [ + { + "kind": "p", + "text": "Все курсы на t27.ai теперь бесплатные, для каждого читателя и сколько бы курсов он ни открыл. До сегодня лестница давала бесплатно любые три курса, а с четвёртого просила клуб. Владелец, 2026-10-19: наша задача — раскачать язык. Курс, который просит клуб, — это читатель, которого язык не получает." + }, + { + "kind": "h", + "text": "Одна функция, и сначала в спеке" + }, + { + "kind": "p", + "text": "Какой курс бесплатный, решает не сайт. Это step_of в gHashTag/t27 specs/automation/course-access.t27, и с VERSION 3 (t27#10799) она возвращает FREE на каждой ступени. Сайт везёт эту спеку байт в байт и исполняет её тела функций, собранные в WebAssembly (courseAccess.logic.ts, spec-sha256 edd87ade). Рисунок нарисован этими собранными телами: step_of для первых 11 курсов, которые открывает читатель, 0 — бесплатно, 2 — клуб." + }, + { + "kind": "figure", + "svg": "step_of(0..10): v2 and v3 of course-access.t271234567891011v200022222222v300000000000", + "caption": "step_of из собранной course-access.t27: VERSION 2 (сверху) даёт 0 первым трём курсам и 2 (клуб) с четвёртого; VERSION 3 (снизу) даёт 0 всем." + }, + { + "kind": "p", + "text": "Одна ловушка осталась хостам, и спека её называет: браузер читателя хранит ступень, на которой открыт каждый курс, а stays_open закрывает курс, сохранённый на ступени клуба, когда клуб кончается. Поэтому сайт больше не читает сохранённую ступень. Он заново спрашивает step_of для ступени курса, а тест с обратным правилом (читать сохранённую ступень) падает. Замок, ворота и формы оплаты в рублях и TON убраны со страниц курсов." + }, + { + "kind": "h", + "text": "Весь курс на одной странице" + }, + { + "kind": "p", + "text": "У каждого курса теперь есть страница со всеми 27 уроками: цель, текст, задание и собственный виджет урока, под одной ссылкой со своей карточкой превью. Основы — на t27.ai/learn/all/, каждый другой курс — на t27.ai/learn/<курс>/all/, русские — под ru/. Это настоящая страница, а не маршрут #/, поэтому X, Telegram и LinkedIn показывают карточку курса, а не главную." + }, + { + "kind": "p", + "text": "27 живых виджетов утопили бы телефон, поэтому рамка виджета загружается, только когда её урок подходит к экрану ближе чем на 600 px, живых одновременно не больше 3, а рамка дальше 2000 px снимается. Высота каждой рамки занята до загрузки. При прокрутке страницы курса о нейросетях в Chromium на 390 px живых рамок ни разу не было больше 3, а сдвиг вёрстки был 0. На телефоне содержание лежит под большим пальцем, с точкой на каждый урок; с 1440 px оно стоит колонкой рядом с уроками." + }, + { + "kind": "h", + "text": "Виджет из виджетов" + }, + { + "kind": "p", + "text": "Тот же курс — ещё и один встраиваемый виджет, колода курса на t27.ai/widgets/course-deck/: девять вкладок модулей, по три карточки уроков, в каждой работает виджет урока, загружаемый так же лениво. Один виджет служит каждому курсу через ?course=; одиннадцать копий отличались бы только данными. Он стоит в галерее виджетов перед ареной." + }, + { + "kind": "h", + "text": "TRI CLAW внизу каждой страницы курса" + }, + { + "kind": "ul", + "items": [ + "Бесплатно со своим ключом: добавьте API-ключ (сегодня NVIDIA или z.ai), и агент работает на нём; ещё ключи — в любой момент. Кнопка открывает экран ключей приложения внутри Telegram.", + "Сделаем за вас: клуб в боте, который показывает цену до оплаты.", + "На GitHub: TRI CLAW — ещё и GitHub-приложение, которое проверяет .t27 в пулл-реквестах. Для других репозиториев оно пока не открыто, поэтому кнопка открывает пост о TRI CLAW; одна константа в спеке переключит её на страницу приложения." + ] + }, + { + "kind": "h", + "text": "Вёрстка — тоже спека" + }, + { + "kind": "p", + "text": "Каждое число экранов курса лежит в specs/view/course-view.t27 с тестами: ширина колонки, точки перелома, бюджет рамок, палец 44 px, рамка фокуса 2 px, нижняя граница контраста 4.5:1. Ширину колонки измерили, а не угадали: средний знак текста урока — 0.43 em по-английски и 0.53 em по-русски, поэтому строка в 70 знаков — это 30.1 em и 37.2 em. Колонка 68ch была бы шириной 95 знаков: ch — это ноль, а ноль у Outfit — 0.66 em. Текст и виджет стоят рядом с 1150 px; ниже виджет идёт сразу после задания, на которое отвечает." + }, + { + "kind": "h", + "text": "Чего это не делает" + }, + { + "kind": "ul", + "items": [ + "Экран ключей, который открывает бесплатный путь, добавляется в приложение в gHashTag/999-multibots-telegraf одновременно с этим; пока он не вышел, кнопка открывает бота.", + "Сайт больше не зовёт оплату рендера; клуб оплачивается в боте.", + "Статическая страница урока по-прежнему уезжает вбок на 25 px на телефоне 390 px в Chromium, как и до этой правки; что её расширяет, пока не найдено." + ] + } +] diff --git a/apps/website/src/data/blog/index.ts b/apps/website/src/data/blog/index.ts index 47bbf3a9c3..3246f8fd4c 100644 --- a/apps/website/src/data/blog/index.ts +++ b/apps/website/src/data/blog/index.ts @@ -2,6 +2,36 @@ import type { PostMeta } from './types' /** Индекс блога: список и метаданные без тяжёлых тел публикаций. */ export const postsIndex: PostMeta[] = [ + { + slug: "every-course-free-and-the-whole-course-on-one-page", + title: "Every course is free now, and each one fits on one page that is also a widget", + summary: "[step_of in course-access.t27 VERSION 3 returns FREE for every rung, and the site runs it compiled; the keys screen of the free TRI CLAW path ships in the app separately; the GitHub App is linked only once it is open to other repositories] Every t27.ai course is free for every reader. Each course also has one page with all 27 lessons and their widgets, loaded 3 at a time, and the same course is one embeddable widget of widgets. The course footer offers TRI CLAW three ways.", + date: "2026-10-19", + readingMinutes: 4, + tags: ["t27", "Course", "TRI CLAW"], + receipts: [ + { label: "trinity#1703: every course free, TRI CLAW in the footer, the whole course on one page", href: "https://github.com/gHashTag/trinity/issues/1703" }, + { label: "t27#10799: course-access rules VERSION 3, every course free", href: "https://github.com/gHashTag/t27/pull/10799" }, + { label: "The t27 basics course on one page", href: "https://t27.ai/learn/all/" }, + { label: "Neural networks in t27 on one page", href: "https://t27.ai/learn/neural-networks/all/" }, + { label: "The course deck widget", href: "https://t27.ai/widgets/course-deck/" }, + ], + openQuestions: [ + "The keys screen the free TRI CLAW path opens is added to the app in gHashTag/999-multibots-telegraf; until it ships, the button opens the bot.", + "The TRI CLAW GitHub App is not open to other repositories yet; the footer links its post until CLAW_APP_PUBLIC is true.", + "A static lesson page still scrolls 25 px sideways at 390 px in Chromium, as it did before; what widens it is not found yet.", + ], + published: true, + ru: { + title: "Все курсы теперь бесплатные, и каждый помещается на одну страницу, которая ещё и виджет", + summary: "[step_of в course-access.t27 VERSION 3 возвращает FREE на каждой ступени, и сайт исполняет её собранной; экран ключей бесплатного пути TRI CLAW выходит в приложении отдельно; GitHub-приложение ссылкой — только когда оно откроется другим репозиториям] Каждый курс t27.ai бесплатный для каждого читателя. У каждого курса есть одна страница со всеми 27 уроками и их виджетами, по 3 живых одновременно, и тот же курс — один встраиваемый виджет из виджетов. Подвал курса предлагает TRI CLAW тремя путями.", + openQuestions: [ + "Экран ключей, который открывает бесплатный путь TRI CLAW, добавляется в приложение в gHashTag/999-multibots-telegraf; пока он не вышел, кнопка открывает бота.", + "GitHub-приложение TRI CLAW пока не открыто другим репозиториям; подвал ведёт на его пост, пока CLAW_APP_PUBLIC не станет true.", + "Статическая страница урока по-прежнему уезжает вбок на 25 px на 390 px в Chromium, как и раньше; что её расширяет, пока не найдено.", + ], + }, + }, { slug: "the-queen-and-the-hive-a-course-on-how-the-project-builds-itself", title: "The Queen and the hive: a course on how the project builds itself, 27 widgets on compiled specs", diff --git a/apps/website/src/data/blog/posts.ts b/apps/website/src/data/blog/posts.ts index dbd9cb64a3..ac1dba2f4b 100644 --- a/apps/website/src/data/blog/posts.ts +++ b/apps/website/src/data/blog/posts.ts @@ -1,3 +1,4 @@ +import { body as body_every_course_free_and_the_whole_course_on_one_page, ruBody as ruBody_every_course_free_and_the_whole_course_on_one_page } from './bodies/every-course-free-and-the-whole-course-on-one-page' import { body as body_the_queen_and_the_hive_a_course_on_how_the_project_builds_itself, ruBody as ruBody_the_queen_and_the_hive_a_course_on_how_the_project_builds_itself } from './bodies/the-queen-and-the-hive-a-course-on-how-the-project-builds-itself' import { body as body_a_wasm_interpreter_ran_on_the_board, ruBody as ruBody_a_wasm_interpreter_ran_on_the_board } from './bodies/a-wasm-interpreter-ran-on-the-board' import { body as body_neural_networks_in_t27_a_widget_per_lesson, ruBody as ruBody_neural_networks_in_t27_a_widget_per_lesson } from './bodies/neural-networks-in-t27-a-widget-per-lesson' @@ -116,6 +117,7 @@ import { body as body_features_that_change_no_bits, ruBody as ruBody_features_th import { body as body_one_commit_nine_workflow_outcomes, ruBody as ruBody_one_commit_nine_workflow_outcomes } from './bodies/one-commit-nine-workflow-outcomes' const bodies: Record = { + 'every-course-free-and-the-whole-course-on-one-page': { body: body_every_course_free_and_the_whole_course_on_one_page, ruBody: ruBody_every_course_free_and_the_whole_course_on_one_page }, 'a-wasm-interpreter-ran-on-the-board': { body: body_a_wasm_interpreter_ran_on_the_board, ruBody: ruBody_a_wasm_interpreter_ran_on_the_board }, 'a-3-mb-compiler-spec-to-aarch64-in-5-ms': { body: body_a_3_mb_compiler_spec_to_aarch64_in_5_ms, ruBody: ruBody_a_3_mb_compiler_spec_to_aarch64_in_5_ms }, 'actors-beat-the-loop-on-recovery-not-everywhere': { body: body_actors_beat_the_loop_on_recovery_not_everywhere, ruBody: ruBody_actors_beat_the_loop_on_recovery_not_everywhere }, From f6705ac100e0153a3eab7c13589645b1074af15a Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 19 Oct 2026 05:17:35 +0000 Subject: [PATCH 4/5] fix(courses): review of #1704 -- the nav and llms.txt say every course is free, the deck refuses an unknown course, the view spec holds what it claims (#1703) - Navigation: the Courses note is the ladder spec's SAY_PROMO_TITLE and its Russian ("Every course is free, no sign-up"), not the old "any three free" literal. - specs/catalog/onboarding.t27 COURSE_NOTE (it feeds /llms.txt and /agents.t27): every course is free, the one-page address; regenerated with onboarding-from-spec.mjs, check:onboarding green. - course-deck: ?course= shows SAY_NOT_FOUND instead of t27 basics (pick.js, a pure function; test in course-pages.test.mjs; checked in Chromium for en and ru). - course-view.t27: FOCUS_OFFSET_PX and SETTLE_MS (the frame pool's look after a scroll, now a required parameter of frame-pool.js) join the spec, the deck's K_FOCUS_RING_PX/K_FOCUS_OFFSET_PX/K_SETTLE_MS are held equal to them, the one page's progress bar takes --course-read, and CONTRAST_MIN_X10 is dropped: contrast is measured on the rendered pages, not held by the spec. The generator header and the post now say the spec holds the layout numbers this change decides, not every number. - TRI CLAW's GitHub line says "built to check" in both languages. - CI: Course pages, Course ladder and Course view are their own steps (if: !cancelled()), so the red test:course #29 no longer hides them. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01ScHVrGSr6zZUdwkdC8DR9k --- .github/workflows/website-checks.yml | 26 ++++++++++++++++--- apps/website/i18n/course-ladder.ru.json | 2 +- apps/website/public/agents.t27 | 4 +-- .../public/learn/a-bar-detector/index.html | 1 + .../public/learn/a-bend-at-zero/index.html | 1 + .../learn/a-boundary-of-real-files/index.html | 1 + .../public/learn/a-build-receipt/index.html | 1 + .../a-correlator-finds-the-frame/index.html | 1 + .../learn/a-deploy-mid-flight/index.html | 1 + .../learn/a-dot-product-in-wires/index.html | 1 + .../learn/a-float-cut-by-phi/index.html | 1 + .../public/learn/a-key-rests/index.html | 1 + .../public/learn/a-loss-in-bits/index.html | 1 + .../learn/a-model-on-the-board/index.html | 1 + .../learn/a-neuron-in-chunks/index.html | 1 + .../a-pass-that-checked-nothing/index.html | 1 + .../public/learn/a-recurrent-cell/index.html | 1 + .../public/learn/a-refused-key/index.html | 1 + .../public/learn/a-sign-is-one-bit/index.html | 1 + .../public/learn/a-small-program/index.html | 1 + .../public/learn/a-tasks-life/index.html | 1 + .../public/learn/a-ternary-alu/index.html | 1 + .../public/learn/a-test-block/index.html | 1 + .../public/learn/a-tiny-layer/index.html | 1 + .../public/learn/a-whole-network/index.html | 1 + .../public/learn/a-word-of-27/index.html | 1 + apps/website/public/learn/adam/index.html | 1 + .../learn/add-it-up-every-clock/index.html | 1 + .../public/learn/address-decode/index.html | 1 + .../public/learn/aging-a-label/index.html | 1 + .../public/learn/ai-numbers/all/index.html | 13 +++++----- .../public/learn/ai-numbers/index.html | 1 + apps/website/public/learn/all/index.html | 13 +++++----- .../public/learn/an-encoder-block/index.html | 1 + .../learn/an-honest-scoreboard/index.html | 1 + .../public/learn/anatomy-of-a-tb/index.html | 1 + .../learn/angle-and-magnitude/index.html | 1 + .../learn/arithmetic-and-dsp/all/index.html | 13 +++++----- .../learn/arithmetic-and-dsp/index.html | 1 + apps/website/public/learn/arrays/index.html | 1 + .../public/learn/assertions/index.html | 1 + .../website/public/learn/attention/index.html | 1 + apps/website/public/learn/back-off/index.html | 1 + .../learn/back-to-three-values/index.html | 1 + .../public/learn/backpropagation/index.html | 1 + .../public/learn/balanced-ternary/index.html | 1 + .../learn/batch-normalisation/index.html | 1 + .../learn/baud-and-the-divisor/index.html | 1 + .../learn/bins-of-a-spectrum/index.html | 1 + .../public/learn/bits-and-trits/index.html | 1 + .../learn/blocked-is-not-failed/index.html | 1 + .../public/learn/board-selftest/index.html | 1 + .../public/learn/booths-trick/index.html | 1 + .../learn/bounded-model-checking/index.html | 1 + .../learn/bring-up-on-the-bench/index.html | 1 + .../public/learn/bugs-that-compile/index.html | 1 + .../public/learn/build-verify/index.html | 1 + .../public/learn/bursts-and-ids/index.html | 1 + .../buses-and-peripherals/all/index.html | 13 +++++----- .../learn/buses-and-peripherals/index.html | 1 + .../capstone-a-filter-on-the-board/index.html | 1 + .../public/learn/capstone-diff/index.html | 1 + .../learn/capstone-what-runs-next/index.html | 1 + apps/website/public/learn/capstone/index.html | 1 + .../learn/capture-a-crossing/index.html | 1 + .../public/learn/carry-save/index.html | 1 + .../public/learn/cdc-report/index.html | 1 + .../learn/chip-select-and-widths/index.html | 1 + .../public/learn/claim-and-release/index.html | 1 + .../learn/clocks-and-cdc/all/index.html | 13 +++++----- .../public/learn/clocks-and-cdc/index.html | 1 + .../learn/comments-and-prose/index.html | 1 + .../learn/compare-at-the-top/index.html | 1 + .../public/learn/compare-traces/index.html | 1 + .../public/learn/compiler-stages/index.html | 1 + .../learn/compiles-is-not-correct/index.html | 1 + .../public/learn/consensus-and-any/index.html | 1 + .../website/public/learn/constants/index.html | 1 + .../public/learn/count-the-cells/index.html | 1 + .../public/learn/course/all/index.html | 13 +++++----- apps/website/public/learn/course/index.html | 1 + .../public/learn/coverage-lies/index.html | 1 + .../public/learn/create-clock/index.html | 1 + .../public/learn/cross-entropy/index.html | 1 + .../public/learn/debug-with-waves/index.html | 1 + .../learn/decode-in-one-step/index.html | 1 + .../public/learn/depth-sizing/index.html | 1 + .../public/learn/designing-taps/index.html | 1 + .../learn/directed-vs-random/index.html | 1 + .../does-it-fit-and-close-timing/index.html | 1 + apps/website/public/learn/dropout/index.html | 1 + apps/website/public/learn/elu/index.html | 1 + .../public/learn/embeddings/index.html | 1 + .../learn/end-to-end-scenarios/index.html | 1 + .../public/learn/enough-reviewers/index.html | 1 + apps/website/public/learn/enums/index.html | 1 + .../learn/everything-in-one-bench/index.html | 1 + .../public/learn/expressions/index.html | 1 + .../learn/false-path-and-max-delay/index.html | 1 + .../public/learn/fasm-to-frames/index.html | 1 + .../public/learn/fifo-testbench/index.html | 1 + .../public/learn/five-channels/index.html | 1 + .../learn/five-rules-for-weights/index.html | 1 + .../public/learn/five-trits-a-byte/index.html | 1 + .../public/learn/flip-and-cut/index.html | 1 + .../learn/folding-taps-onto-slices/index.html | 1 + .../learn/four-trit-exponent/index.html | 1 + .../public/learn/fpga-is-a-grid/index.html | 1 + .../learn/frames-and-the-fcs/index.html | 1 + .../learn/framing-a-conversation/index.html | 1 + .../public/learn/fsm-coverage/index.html | 1 + .../public/learn/full-adder/index.html | 1 + .../website/public/learn/functions/index.html | 1 + .../public/learn/gated-clock-trap/index.html | 1 + apps/website/public/learn/gelu/index.html | 1 + apps/website/public/learn/gen-ts/index.html | 1 + .../public/learn/gf10-ten-bits/index.html | 1 + .../learn/gf1024-one-kilobit/index.html | 1 + .../public/learn/gf12-twelve-bits/index.html | 1 + .../public/learn/gf128-a-quad/index.html | 1 + .../learn/gf14-fourteen-bits/index.html | 1 + .../public/learn/gf16-the-primary/index.html | 1 + .../learn/gf24-twenty-four-bits/index.html | 1 + .../learn/gf256-two-five-six/index.html | 1 + .../public/learn/gf32-a-single/index.html | 1 + .../public/learn/gf4-four-bits/index.html | 1 + .../learn/gf48-forty-eight-bits/index.html | 1 + .../public/learn/gf512-five-twelve/index.html | 1 + .../public/learn/gf6-six-bits/index.html | 1 + .../public/learn/gf64-a-double/index.html | 1 + .../public/learn/gf8-one-byte/index.html | 1 + .../learn/gf96-ninety-six-bits/index.html | 1 + .../public/learn/gft16-six-trits/index.html | 1 + .../learn/gft32-twelve-trits/index.html | 1 + .../learn/gft8-exponent-in-trits/index.html | 1 + .../public/learn/global-buffers/index.html | 1 + .../public/learn/golden-model/index.html | 1 + .../learn/golden-ruler-vectors/index.html | 1 + .../public/learn/goldenfloat/all/index.html | 13 +++++----- .../public/learn/goldenfloat/index.html | 1 + .../public/learn/gradient-descent/index.html | 1 + .../website/public/learn/gray-code/index.html | 1 + .../growth-through-the-stages/index.html | 1 + .../public/learn/half-adder/index.html | 1 + .../learn/handshakes-and-pulses/index.html | 1 + .../website/public/learn/hello-t27/index.html | 1 + .../public/learn/how-much-fits/index.html | 1 + .../public/learn/if-and-else/index.html | 1 + apps/website/public/learn/index.html | 1 + .../website/public/learn/induction/index.html | 1 + .../public/learn/inherited-red/index.html | 1 + .../public/learn/invariants/index.html | 1 + .../website/public/learn/io-timing/index.html | 1 + .../learn/jtag-asks-the-chip/index.html | 1 + .../public/learn/kill-the-mutant/index.html | 1 + .../public/learn/kleene-logic/index.html | 1 + .../learn/lamb-and-large-batches/index.html | 1 + apps/website/public/learn/latency/index.html | 1 + .../public/learn/learning-xor/index.html | 1 + .../public/learn/line-and-toggle/index.html | 1 + .../public/learn/lite-or-full/index.html | 1 + .../public/learn/local-names/index.html | 1 + .../public/learn/logic-depth/index.html | 1 + .../learn/long-multiplication/index.html | 1 + apps/website/public/learn/loops/index.html | 1 + .../public/learn/lowering-the-rate/index.html | 1 + .../public/learn/lstm-gates/index.html | 1 + .../learn/lucas-numbers-stay-whole/index.html | 1 + .../public/learn/many-tests/index.html | 1 + .../learn/master-and-servant/index.html | 1 + .../public/learn/max-pooling/index.html | 1 + .../learn/mean-squared-error/index.html | 1 + .../public/learn/memory-maps/index.html | 1 + .../public/learn/modes-cpol-cpha/index.html | 1 + apps/website/public/learn/mtbf/index.html | 1 + .../learn/multiply-and-divide/index.html | 1 + .../public/learn/multiply-then-add/index.html | 1 + .../public/learn/negate-twice/index.html | 1 + .../learn/neural-networks/all/index.html | 13 +++++----- .../public/learn/neural-networks/index.html | 1 + .../learn/no-credit-for-keys/index.html | 1 + .../learn/one-edge-one-world/index.html | 1 + .../public/learn/one-lut-up-close/index.html | 1 + .../public/learn/one-outlier/index.html | 1 + .../learn/one-scale-per-block/index.html | 1 + .../public/learn/one-step-downhill/index.html | 1 + .../learn/one-task-three-kinds/index.html | 1 + .../learn/one-ternary-neuron/index.html | 1 + .../learn/opposite-signs-subtract/index.html | 1 + .../learn/patches-of-a-picture/index.html | 1 + .../public/learn/period-and-jitter/index.html | 1 + .../public/learn/phase-and-lock/index.html | 1 + .../public/learn/phi-as-a-ratio/index.html | 1 + .../learn/phi-in-sixteen-bits/index.html | 1 + .../learn/phi-scaled-ternary/index.html | 1 + .../public/learn/pick-the-largest/index.html | 1 + .../public/learn/pins-and-package/index.html | 1 + .../website/public/learn/placement/index.html | 1 + .../public/learn/plan-before-code/index.html | 1 + .../learn/pointers-and-flags/index.html | 1 + .../website/public/learn/polyphase/index.html | 1 + .../public/learn/ports-and-kinds/index.html | 1 + .../learn/positional-encoding/index.html | 1 + .../learn/ppo-and-the-reward/index.html | 1 + .../public/learn/prefix-adders/index.html | 1 + .../public/learn/psel-and-penable/index.html | 1 + .../public/learn/pub-or-private/index.html | 1 + .../website/public/learn/q-formats/index.html | 1 + .../learn/quantization-noise/index.html | 1 + .../learn/queen-and-hive/all/index.html | 13 +++++----- .../public/learn/queen-and-hive/index.html | 1 + .../learn/questions-in-thirds/index.html | 1 + .../public/learn/read-a-bitstream/index.html | 1 + .../public/learn/reading-errors/index.html | 1 + .../public/learn/related-or-not/index.html | 1 + apps/website/public/learn/relu/index.html | 1 + .../public/learn/reset-fanout/index.html | 1 + .../public/learn/reset-release/index.html | 1 + .../public/learn/review-first/index.html | 1 + .../public/learn/rgmii-timing/index.html | 1 + .../public/learn/ripple-carry/index.html | 1 + apps/website/public/learn/rmsprop/index.html | 1 + .../learn/rotating-by-shifts/index.html | 1 + .../learn/rounding-and-saturation/index.html | 1 + .../public/learn/run-a-program/index.html | 1 + .../learn/same-bits-on-the-board/index.html | 1 + .../learn/same-neuron-new-weights/index.html | 1 + .../learn/sampling-and-aliasing/index.html | 1 + .../public/learn/scale-byte-native/index.html | 1 + .../public/learn/self-checking/index.html | 1 + .../public/learn/setup-hold-window/index.html | 1 + .../learn/seven-backends-and-t27b/index.html | 1 + .../public/learn/seven-backends/index.html | 1 + .../public/learn/shaping-an-issue/index.html | 1 + .../public/learn/shift-and-add/index.html | 1 + .../learn/simulator-internals/index.html | 1 + .../learn/skew-and-insertion/index.html | 1 + .../learn/softmax-and-temperature/index.html | 1 + .../public/learn/sort-by-three/index.html | 1 + .../public/learn/spec-to-verilog/index.html | 1 + .../public/learn/stages-of-t27c/index.html | 1 + .../public/learn/state-machines/index.html | 1 + .../public/learn/status-and-fifos/index.html | 1 + .../public/learn/stop-and-mute/index.html | 1 + .../public/learn/strobes-and-waits/index.html | 1 + apps/website/public/learn/structs/index.html | 1 + .../public/learn/sum-and-carry/index.html | 1 + .../public/learn/surviving-mutants/index.html | 1 + .../public/learn/swish-and-silu/index.html | 1 + .../public/learn/sync-or-async/index.html | 1 + .../learn/synthesis-warnings/index.html | 1 + .../public/learn/t27-number-format/index.html | 1 + .../learn/t27c-on-a-real-machine/index.html | 1 + .../learn/tables-and-interpolation/index.html | 1 + .../learn/tanh-and-saturation/index.html | 1 + .../learn/ternary-computing/all/index.html | 13 +++++----- .../public/learn/ternary-computing/index.html | 1 + .../public/learn/ternary-mac/index.html | 1 + .../public/learn/test-strength/index.html | 1 + .../learn/tests-are-the-spec/index.html | 1 + .../public/learn/the-butterfly/index.html | 1 + .../public/learn/the-carry-chain/index.html | 1 + .../public/learn/the-cic-filter/index.html | 1 + .../public/learn/the-comb-answers/index.html | 1 + .../public/learn/the-dsp48e1-slice/index.html | 1 + .../website/public/learn/the-frame/index.html | 1 + .../public/learn/the-huber-loss/index.html | 1 + .../public/learn/the-immediate/index.html | 1 + .../learn/the-instruction-word/index.html | 1 + .../public/learn/the-merge-gate/index.html | 1 + .../public/learn/the-module-line/index.html | 1 + .../learn/the-moving-average/index.html | 1 + apps/website/public/learn/the-nco/index.html | 1 + .../public/learn/the-next-key/index.html | 1 + .../public/learn/the-night-watch/index.html | 1 + .../public/learn/the-opcode-map/index.html | 1 + .../public/learn/the-packet-bridge/index.html | 1 + .../learn/the-prescaler-ladder/index.html | 1 + .../public/learn/the-public-board/index.html | 1 + .../public/learn/the-queens-move/index.html | 1 + .../website/public/learn/the-queue/index.html | 1 + .../public/learn/the-review-jam/index.html | 1 + .../learn/the-ship-flies-home/index.html | 1 + .../public/learn/the-sigmoid/index.html | 1 + .../public/learn/three-bots-deep/index.html | 1 + .../learn/three-way-agreement/index.html | 1 + .../public/learn/three-way-jump/index.html | 1 + .../public/learn/times-a-trit/index.html | 1 + .../public/learn/timing-slack/index.html | 1 + .../public/learn/tokens-that-burn/index.html | 1 + .../public/learn/tri-commands/index.html | 1 + apps/website/public/learn/trits/index.html | 1 + .../learn/true-false-and-text/index.html | 1 + .../public/learn/twice-the-cost/index.html | 1 + .../twiddles-and-bit-reversal/index.html | 1 + .../public/learn/two-bits-per-trit/index.html | 1 + .../public/learn/two-flop-sync/index.html | 1 + .../learn/two-products-one-sum/index.html | 1 + .../public/learn/two-to-the-x/index.html | 1 + .../public/learn/use-other-modules/index.html | 1 + .../public/learn/vcd-format/index.html | 1 + .../public/learn/verify-capstone/index.html | 1 + .../learn/verify-hardware/all/index.html | 13 +++++----- .../public/learn/verify-hardware/index.html | 1 + .../public/learn/what-a-spec-is/index.html | 1 + .../public/learn/what-a-vector-is/index.html | 1 + .../learn/what-arithmetic-costs/index.html | 1 + .../learn/when-they-disagree/index.html | 1 + .../public/learn/where-next/index.html | 1 + .../learn/where-the-clock-enters/index.html | 1 + .../public/learn/where-the-luts-go/index.html | 1 + .../public/learn/which-chip/index.html | 1 + .../public/learn/who-holds-the-io/index.html | 1 + .../public/learn/who-is-called/index.html | 1 + .../public/learn/whole-numbers/index.html | 1 + .../public/learn/why-base-three/index.html | 1 + .../public/learn/why-binary-fails/index.html | 1 + .../public/learn/why-bridges/index.html | 1 + .../learn/why-the-split-is-phi/index.html | 1 + .../website/public/learn/why-three/index.html | 1 + .../public/learn/wires-that-talk/index.html | 1 + .../public/learn/xor-needs-a-bend/index.html | 1 + apps/website/public/llms.txt | 4 +-- .../public/ru/learn/a-bar-detector/index.html | 3 ++- .../public/ru/learn/a-bend-at-zero/index.html | 3 ++- .../learn/a-boundary-of-real-files/index.html | 3 ++- .../ru/learn/a-build-receipt/index.html | 3 ++- .../a-correlator-finds-the-frame/index.html | 3 ++- .../ru/learn/a-deploy-mid-flight/index.html | 3 ++- .../learn/a-dot-product-in-wires/index.html | 3 ++- .../ru/learn/a-float-cut-by-phi/index.html | 3 ++- .../public/ru/learn/a-key-rests/index.html | 3 ++- .../public/ru/learn/a-loss-in-bits/index.html | 3 ++- .../ru/learn/a-model-on-the-board/index.html | 3 ++- .../ru/learn/a-neuron-in-chunks/index.html | 3 ++- .../a-pass-that-checked-nothing/index.html | 3 ++- .../ru/learn/a-recurrent-cell/index.html | 3 ++- .../public/ru/learn/a-refused-key/index.html | 3 ++- .../ru/learn/a-sign-is-one-bit/index.html | 3 ++- .../ru/learn/a-small-program/index.html | 3 ++- .../public/ru/learn/a-tasks-life/index.html | 3 ++- .../public/ru/learn/a-ternary-alu/index.html | 3 ++- .../public/ru/learn/a-test-block/index.html | 3 ++- .../public/ru/learn/a-tiny-layer/index.html | 3 ++- .../ru/learn/a-whole-network/index.html | 3 ++- .../public/ru/learn/a-word-of-27/index.html | 3 ++- apps/website/public/ru/learn/adam/index.html | 3 ++- .../ru/learn/add-it-up-every-clock/index.html | 3 ++- .../public/ru/learn/address-decode/index.html | 3 ++- .../public/ru/learn/aging-a-label/index.html | 3 ++- .../public/ru/learn/ai-numbers/all/index.html | 15 ++++++----- .../public/ru/learn/ai-numbers/index.html | 3 ++- apps/website/public/ru/learn/all/index.html | 15 ++++++----- .../ru/learn/an-encoder-block/index.html | 3 ++- .../ru/learn/an-honest-scoreboard/index.html | 3 ++- .../ru/learn/anatomy-of-a-tb/index.html | 3 ++- .../ru/learn/angle-and-magnitude/index.html | 3 ++- .../learn/arithmetic-and-dsp/all/index.html | 15 ++++++----- .../ru/learn/arithmetic-and-dsp/index.html | 3 ++- .../website/public/ru/learn/arrays/index.html | 3 ++- .../public/ru/learn/assertions/index.html | 3 ++- .../public/ru/learn/attention/index.html | 3 ++- .../public/ru/learn/back-off/index.html | 3 ++- .../ru/learn/back-to-three-values/index.html | 3 ++- .../ru/learn/backpropagation/index.html | 3 ++- .../ru/learn/balanced-ternary/index.html | 3 ++- .../ru/learn/batch-normalisation/index.html | 3 ++- .../ru/learn/baud-and-the-divisor/index.html | 3 ++- .../ru/learn/bins-of-a-spectrum/index.html | 3 ++- .../public/ru/learn/bits-and-trits/index.html | 3 ++- .../ru/learn/blocked-is-not-failed/index.html | 3 ++- .../public/ru/learn/board-selftest/index.html | 3 ++- .../public/ru/learn/booths-trick/index.html | 3 ++- .../learn/bounded-model-checking/index.html | 3 ++- .../ru/learn/bring-up-on-the-bench/index.html | 3 ++- .../ru/learn/bugs-that-compile/index.html | 3 ++- .../public/ru/learn/build-verify/index.html | 3 ++- .../public/ru/learn/bursts-and-ids/index.html | 3 ++- .../buses-and-peripherals/all/index.html | 15 ++++++----- .../ru/learn/buses-and-peripherals/index.html | 3 ++- .../capstone-a-filter-on-the-board/index.html | 3 ++- .../public/ru/learn/capstone-diff/index.html | 3 ++- .../learn/capstone-what-runs-next/index.html | 3 ++- .../public/ru/learn/capstone/index.html | 3 ++- .../ru/learn/capture-a-crossing/index.html | 3 ++- .../public/ru/learn/carry-save/index.html | 3 ++- .../public/ru/learn/cdc-report/index.html | 3 ++- .../learn/chip-select-and-widths/index.html | 3 ++- .../ru/learn/claim-and-release/index.html | 3 ++- .../ru/learn/clocks-and-cdc/all/index.html | 15 ++++++----- .../public/ru/learn/clocks-and-cdc/index.html | 3 ++- .../ru/learn/comments-and-prose/index.html | 3 ++- .../ru/learn/compare-at-the-top/index.html | 3 ++- .../public/ru/learn/compare-traces/index.html | 3 ++- .../ru/learn/compiler-stages/index.html | 3 ++- .../learn/compiles-is-not-correct/index.html | 3 ++- .../ru/learn/consensus-and-any/index.html | 3 ++- .../public/ru/learn/constants/index.html | 3 ++- .../ru/learn/count-the-cells/index.html | 3 ++- .../public/ru/learn/course/all/index.html | 15 ++++++----- .../website/public/ru/learn/course/index.html | 3 ++- .../public/ru/learn/coverage-lies/index.html | 3 ++- .../public/ru/learn/create-clock/index.html | 3 ++- .../public/ru/learn/cross-entropy/index.html | 3 ++- .../ru/learn/debug-with-waves/index.html | 3 ++- .../ru/learn/decode-in-one-step/index.html | 3 ++- .../public/ru/learn/depth-sizing/index.html | 3 ++- .../public/ru/learn/designing-taps/index.html | 3 ++- .../ru/learn/directed-vs-random/index.html | 3 ++- .../does-it-fit-and-close-timing/index.html | 3 ++- .../public/ru/learn/dropout/index.html | 3 ++- apps/website/public/ru/learn/elu/index.html | 3 ++- .../public/ru/learn/embeddings/index.html | 3 ++- .../ru/learn/end-to-end-scenarios/index.html | 3 ++- .../ru/learn/enough-reviewers/index.html | 3 ++- apps/website/public/ru/learn/enums/index.html | 3 ++- .../learn/everything-in-one-bench/index.html | 3 ++- .../public/ru/learn/expressions/index.html | 3 ++- .../learn/false-path-and-max-delay/index.html | 3 ++- .../public/ru/learn/fasm-to-frames/index.html | 3 ++- .../public/ru/learn/fifo-testbench/index.html | 3 ++- .../public/ru/learn/five-channels/index.html | 3 ++- .../learn/five-rules-for-weights/index.html | 3 ++- .../ru/learn/five-trits-a-byte/index.html | 3 ++- .../public/ru/learn/flip-and-cut/index.html | 3 ++- .../learn/folding-taps-onto-slices/index.html | 3 ++- .../ru/learn/four-trit-exponent/index.html | 3 ++- .../public/ru/learn/fpga-is-a-grid/index.html | 3 ++- .../ru/learn/frames-and-the-fcs/index.html | 3 ++- .../learn/framing-a-conversation/index.html | 3 ++- .../public/ru/learn/fsm-coverage/index.html | 3 ++- .../public/ru/learn/full-adder/index.html | 3 ++- .../public/ru/learn/functions/index.html | 3 ++- .../ru/learn/gated-clock-trap/index.html | 3 ++- apps/website/public/ru/learn/gelu/index.html | 3 ++- .../website/public/ru/learn/gen-ts/index.html | 3 ++- .../public/ru/learn/gf10-ten-bits/index.html | 3 ++- .../ru/learn/gf1024-one-kilobit/index.html | 3 ++- .../ru/learn/gf12-twelve-bits/index.html | 3 ++- .../public/ru/learn/gf128-a-quad/index.html | 3 ++- .../ru/learn/gf14-fourteen-bits/index.html | 3 ++- .../ru/learn/gf16-the-primary/index.html | 3 ++- .../ru/learn/gf24-twenty-four-bits/index.html | 3 ++- .../ru/learn/gf256-two-five-six/index.html | 3 ++- .../public/ru/learn/gf32-a-single/index.html | 3 ++- .../public/ru/learn/gf4-four-bits/index.html | 3 ++- .../ru/learn/gf48-forty-eight-bits/index.html | 3 ++- .../ru/learn/gf512-five-twelve/index.html | 3 ++- .../public/ru/learn/gf6-six-bits/index.html | 3 ++- .../public/ru/learn/gf64-a-double/index.html | 3 ++- .../public/ru/learn/gf8-one-byte/index.html | 3 ++- .../ru/learn/gf96-ninety-six-bits/index.html | 3 ++- .../ru/learn/gft16-six-trits/index.html | 3 ++- .../ru/learn/gft32-twelve-trits/index.html | 3 ++- .../learn/gft8-exponent-in-trits/index.html | 3 ++- .../public/ru/learn/global-buffers/index.html | 3 ++- .../public/ru/learn/golden-model/index.html | 3 ++- .../ru/learn/golden-ruler-vectors/index.html | 3 ++- .../ru/learn/goldenfloat/all/index.html | 15 ++++++----- .../public/ru/learn/goldenfloat/index.html | 3 ++- .../ru/learn/gradient-descent/index.html | 3 ++- .../public/ru/learn/gray-code/index.html | 3 ++- .../growth-through-the-stages/index.html | 3 ++- .../public/ru/learn/half-adder/index.html | 3 ++- .../ru/learn/handshakes-and-pulses/index.html | 3 ++- .../public/ru/learn/hello-t27/index.html | 3 ++- .../public/ru/learn/how-much-fits/index.html | 3 ++- .../public/ru/learn/if-and-else/index.html | 3 ++- apps/website/public/ru/learn/index.html | 3 ++- .../public/ru/learn/induction/index.html | 3 ++- .../public/ru/learn/inherited-red/index.html | 3 ++- .../public/ru/learn/invariants/index.html | 3 ++- .../public/ru/learn/io-timing/index.html | 3 ++- .../ru/learn/jtag-asks-the-chip/index.html | 3 ++- .../ru/learn/kill-the-mutant/index.html | 3 ++- .../public/ru/learn/kleene-logic/index.html | 3 ++- .../learn/lamb-and-large-batches/index.html | 3 ++- .../public/ru/learn/latency/index.html | 3 ++- .../public/ru/learn/learning-xor/index.html | 3 ++- .../ru/learn/line-and-toggle/index.html | 3 ++- .../public/ru/learn/lite-or-full/index.html | 3 ++- .../public/ru/learn/local-names/index.html | 3 ++- .../public/ru/learn/logic-depth/index.html | 3 ++- .../ru/learn/long-multiplication/index.html | 3 ++- apps/website/public/ru/learn/loops/index.html | 3 ++- .../ru/learn/lowering-the-rate/index.html | 3 ++- .../public/ru/learn/lstm-gates/index.html | 3 ++- .../learn/lucas-numbers-stay-whole/index.html | 3 ++- .../public/ru/learn/many-tests/index.html | 3 ++- .../ru/learn/master-and-servant/index.html | 3 ++- .../public/ru/learn/max-pooling/index.html | 3 ++- .../ru/learn/mean-squared-error/index.html | 3 ++- .../public/ru/learn/memory-maps/index.html | 3 ++- .../ru/learn/modes-cpol-cpha/index.html | 3 ++- apps/website/public/ru/learn/mtbf/index.html | 3 ++- .../ru/learn/multiply-and-divide/index.html | 3 ++- .../ru/learn/multiply-then-add/index.html | 3 ++- .../public/ru/learn/negate-twice/index.html | 3 ++- .../ru/learn/neural-networks/all/index.html | 15 ++++++----- .../ru/learn/neural-networks/index.html | 3 ++- .../ru/learn/no-credit-for-keys/index.html | 3 ++- .../ru/learn/one-edge-one-world/index.html | 3 ++- .../ru/learn/one-lut-up-close/index.html | 3 ++- .../public/ru/learn/one-outlier/index.html | 3 ++- .../ru/learn/one-scale-per-block/index.html | 3 ++- .../ru/learn/one-step-downhill/index.html | 3 ++- .../ru/learn/one-task-three-kinds/index.html | 3 ++- .../ru/learn/one-ternary-neuron/index.html | 3 ++- .../learn/opposite-signs-subtract/index.html | 3 ++- .../ru/learn/patches-of-a-picture/index.html | 3 ++- .../ru/learn/period-and-jitter/index.html | 3 ++- .../public/ru/learn/phase-and-lock/index.html | 3 ++- .../public/ru/learn/phi-as-a-ratio/index.html | 3 ++- .../ru/learn/phi-in-sixteen-bits/index.html | 3 ++- .../ru/learn/phi-scaled-ternary/index.html | 3 ++- .../ru/learn/pick-the-largest/index.html | 3 ++- .../ru/learn/pins-and-package/index.html | 3 ++- .../public/ru/learn/placement/index.html | 3 ++- .../ru/learn/plan-before-code/index.html | 3 ++- .../ru/learn/pointers-and-flags/index.html | 3 ++- .../public/ru/learn/polyphase/index.html | 3 ++- .../ru/learn/ports-and-kinds/index.html | 3 ++- .../ru/learn/positional-encoding/index.html | 3 ++- .../ru/learn/ppo-and-the-reward/index.html | 3 ++- .../public/ru/learn/prefix-adders/index.html | 3 ++- .../ru/learn/psel-and-penable/index.html | 3 ++- .../public/ru/learn/pub-or-private/index.html | 3 ++- .../public/ru/learn/q-formats/index.html | 3 ++- .../ru/learn/quantization-noise/index.html | 3 ++- .../ru/learn/queen-and-hive/all/index.html | 15 ++++++----- .../public/ru/learn/queen-and-hive/index.html | 3 ++- .../ru/learn/questions-in-thirds/index.html | 3 ++- .../ru/learn/read-a-bitstream/index.html | 3 ++- .../public/ru/learn/reading-errors/index.html | 3 ++- .../public/ru/learn/related-or-not/index.html | 3 ++- apps/website/public/ru/learn/relu/index.html | 3 ++- .../public/ru/learn/reset-fanout/index.html | 3 ++- .../public/ru/learn/reset-release/index.html | 3 ++- .../public/ru/learn/review-first/index.html | 3 ++- .../public/ru/learn/rgmii-timing/index.html | 3 ++- .../public/ru/learn/ripple-carry/index.html | 3 ++- .../public/ru/learn/rmsprop/index.html | 3 ++- .../ru/learn/rotating-by-shifts/index.html | 3 ++- .../learn/rounding-and-saturation/index.html | 3 ++- .../public/ru/learn/run-a-program/index.html | 3 ++- .../learn/same-bits-on-the-board/index.html | 3 ++- .../learn/same-neuron-new-weights/index.html | 3 ++- .../ru/learn/sampling-and-aliasing/index.html | 3 ++- .../ru/learn/scale-byte-native/index.html | 3 ++- .../public/ru/learn/self-checking/index.html | 3 ++- .../ru/learn/setup-hold-window/index.html | 3 ++- .../learn/seven-backends-and-t27b/index.html | 3 ++- .../public/ru/learn/seven-backends/index.html | 3 ++- .../ru/learn/shaping-an-issue/index.html | 3 ++- .../public/ru/learn/shift-and-add/index.html | 3 ++- .../ru/learn/simulator-internals/index.html | 3 ++- .../ru/learn/skew-and-insertion/index.html | 3 ++- .../learn/softmax-and-temperature/index.html | 3 ++- .../public/ru/learn/sort-by-three/index.html | 3 ++- .../ru/learn/spec-to-verilog/index.html | 3 ++- .../public/ru/learn/stages-of-t27c/index.html | 3 ++- .../public/ru/learn/state-machines/index.html | 3 ++- .../ru/learn/status-and-fifos/index.html | 3 ++- .../public/ru/learn/stop-and-mute/index.html | 3 ++- .../ru/learn/strobes-and-waits/index.html | 3 ++- .../public/ru/learn/structs/index.html | 3 ++- .../public/ru/learn/sum-and-carry/index.html | 3 ++- .../ru/learn/surviving-mutants/index.html | 3 ++- .../public/ru/learn/swish-and-silu/index.html | 3 ++- .../public/ru/learn/sync-or-async/index.html | 3 ++- .../ru/learn/synthesis-warnings/index.html | 3 ++- .../ru/learn/t27-number-format/index.html | 3 ++- .../learn/t27c-on-a-real-machine/index.html | 3 ++- .../learn/tables-and-interpolation/index.html | 3 ++- .../ru/learn/tanh-and-saturation/index.html | 3 ++- .../ru/learn/ternary-computing/all/index.html | 15 ++++++----- .../ru/learn/ternary-computing/index.html | 3 ++- .../public/ru/learn/ternary-mac/index.html | 3 ++- .../public/ru/learn/test-strength/index.html | 3 ++- .../ru/learn/tests-are-the-spec/index.html | 3 ++- .../public/ru/learn/the-butterfly/index.html | 3 ++- .../ru/learn/the-carry-chain/index.html | 3 ++- .../public/ru/learn/the-cic-filter/index.html | 3 ++- .../ru/learn/the-comb-answers/index.html | 3 ++- .../ru/learn/the-dsp48e1-slice/index.html | 3 ++- .../public/ru/learn/the-frame/index.html | 3 ++- .../public/ru/learn/the-huber-loss/index.html | 3 ++- .../public/ru/learn/the-immediate/index.html | 3 ++- .../ru/learn/the-instruction-word/index.html | 3 ++- .../public/ru/learn/the-merge-gate/index.html | 3 ++- .../ru/learn/the-module-line/index.html | 3 ++- .../ru/learn/the-moving-average/index.html | 3 ++- .../public/ru/learn/the-nco/index.html | 3 ++- .../public/ru/learn/the-next-key/index.html | 3 ++- .../ru/learn/the-night-watch/index.html | 3 ++- .../public/ru/learn/the-opcode-map/index.html | 3 ++- .../ru/learn/the-packet-bridge/index.html | 3 ++- .../ru/learn/the-prescaler-ladder/index.html | 3 ++- .../ru/learn/the-public-board/index.html | 3 ++- .../ru/learn/the-queens-move/index.html | 3 ++- .../public/ru/learn/the-queue/index.html | 3 ++- .../public/ru/learn/the-review-jam/index.html | 3 ++- .../ru/learn/the-ship-flies-home/index.html | 3 ++- .../public/ru/learn/the-sigmoid/index.html | 3 ++- .../ru/learn/three-bots-deep/index.html | 3 ++- .../ru/learn/three-way-agreement/index.html | 3 ++- .../public/ru/learn/three-way-jump/index.html | 3 ++- .../public/ru/learn/times-a-trit/index.html | 3 ++- .../public/ru/learn/timing-slack/index.html | 3 ++- .../ru/learn/tokens-that-burn/index.html | 3 ++- .../public/ru/learn/tri-commands/index.html | 3 ++- apps/website/public/ru/learn/trits/index.html | 3 ++- .../ru/learn/true-false-and-text/index.html | 3 ++- .../public/ru/learn/twice-the-cost/index.html | 3 ++- .../twiddles-and-bit-reversal/index.html | 3 ++- .../ru/learn/two-bits-per-trit/index.html | 3 ++- .../public/ru/learn/two-flop-sync/index.html | 3 ++- .../ru/learn/two-products-one-sum/index.html | 3 ++- .../public/ru/learn/two-to-the-x/index.html | 3 ++- .../ru/learn/use-other-modules/index.html | 3 ++- .../public/ru/learn/vcd-format/index.html | 3 ++- .../ru/learn/verify-capstone/index.html | 3 ++- .../ru/learn/verify-hardware/all/index.html | 15 ++++++----- .../ru/learn/verify-hardware/index.html | 3 ++- .../public/ru/learn/what-a-spec-is/index.html | 3 ++- .../ru/learn/what-a-vector-is/index.html | 3 ++- .../ru/learn/what-arithmetic-costs/index.html | 3 ++- .../ru/learn/when-they-disagree/index.html | 3 ++- .../public/ru/learn/where-next/index.html | 3 ++- .../learn/where-the-clock-enters/index.html | 3 ++- .../ru/learn/where-the-luts-go/index.html | 3 ++- .../public/ru/learn/which-chip/index.html | 3 ++- .../ru/learn/who-holds-the-io/index.html | 3 ++- .../public/ru/learn/who-is-called/index.html | 3 ++- .../public/ru/learn/whole-numbers/index.html | 3 ++- .../public/ru/learn/why-base-three/index.html | 3 ++- .../ru/learn/why-binary-fails/index.html | 3 ++- .../public/ru/learn/why-bridges/index.html | 3 ++- .../ru/learn/why-the-split-is-phi/index.html | 3 ++- .../public/ru/learn/why-three/index.html | 3 ++- .../ru/learn/wires-that-talk/index.html | 3 ++- .../ru/learn/xor-needs-a-bend/index.html | 3 ++- .../widgets/course-deck/course-deck.t27 | 7 ++++- .../public/widgets/course-deck/index.html | 10 +++---- .../public/widgets/course-deck/pick.js | 9 +++++++ .../public/widgets/course-deck/tool.css | 4 +-- .../public/widgets/course-deck/tool.js | 12 ++++++--- apps/website/public/widgets/frame-pool.js | 15 ++++++----- apps/website/scripts/course-onepage.mjs | 10 +++---- apps/website/scripts/course-pages.test.mjs | 15 +++++++++++ .../website/scripts/course-view-from-spec.mjs | 16 +++++++----- apps/website/specs/catalog/onboarding.t27 | 2 +- apps/website/specs/view/course-view.t27 | 24 ++++++++++++----- apps/website/specs/widgets/course-deck.t27 | 7 ++++- apps/website/src/components/Navigation.tsx | 5 ++-- ...e-free-and-the-whole-course-on-one-page.ts | 8 +++--- .../website/src/lib/courseLadder.generated.ts | 2 +- apps/website/src/lib/courseView.generated.ts | 5 ++-- apps/website/src/pages/Course.css | 2 +- .../src/styles/courseView.generated.css | 3 ++- 660 files changed, 1221 insertions(+), 511 deletions(-) create mode 100644 apps/website/public/widgets/course-deck/pick.js diff --git a/.github/workflows/website-checks.yml b/.github/workflows/website-checks.yml index b332c8d120..553e79547b 100644 --- a/.github/workflows/website-checks.yml +++ b/.github/workflows/website-checks.yml @@ -475,11 +475,29 @@ jobs: # that is missing or changes a number. A crawler drops the '#', so every # lesson also has a static page with its own preview card at /learn// # and /ru/learn//, and every course a landing at its share path; the - # check refuses a page, card or learn/sitemap.xml that lags the specs. The - # layout numbers (reading width, breakpoints, the widget frame budget of the - # one-page view and the course deck) are specs/view/course-view.t27. + # check refuses a page, card or learn/sitemap.xml that lags the specs. - name: Course - run: npm run check:course && npm run test:course && npm run check:course-pages && npm run check:course-ladder && npm run test:course-ladder && npm run check:course-view && npm run test:course-view + run: npm run check:course && npm run test:course + + # The gates below do not depend on the one above: each runs on its own, so + # a red test in test:course does not hide them. + # The course pages: every lesson, course and whole-course-on-one-page view + # (learn//all/) is current with its card and the sitemap. + - name: Course pages + if: ${{ !cancelled() }} + run: npm run check:course-pages + + # The rules (course-access.t27, vendored, run compiled) and the words of the + # catalog, the course cards and the TRI CLAW block. + - name: Course ladder + if: ${{ !cancelled() }} + run: npm run check:course-ladder && npm run test:course-ladder + + # The layout numbers (reading width, breakpoints, the widget frame budget of + # the one-page view and the course deck) are specs/view/course-view.t27. + - name: Course view + if: ${{ !cancelled() }} + run: npm run check:course-view && npm run test:course-view # The IGLA board on WARS: specs/queen/igla_board.t27 is generated in # gHashTag/igla-coder-gpu from committed artifacts. The gate recompiles it, diff --git a/apps/website/i18n/course-ladder.ru.json b/apps/website/i18n/course-ladder.ru.json index cdbb4761fa..653d021b2c 100644 --- a/apps/website/i18n/course-ladder.ru.json +++ b/apps/website/i18n/course-ladder.ru.json @@ -26,6 +26,6 @@ "SAY_CLAW_APP_LINE": "GitHub-приложение TRI CLAW проверяет спеки .t27, которые меняет пулл-реквест.", "SAY_CLAW_APP_PRESS": "Установить TRI CLAW в свой репозиторий", "SAY_CLAW_POST_TITLE": "На GitHub", - "SAY_CLAW_POST_LINE": "TRI CLAW — ещё и GitHub-приложение, которое проверяет спеки .t27 в пулл-реквестах. Для других репозиториев оно пока не открыто.", + "SAY_CLAW_POST_LINE": "TRI CLAW — ещё и GitHub-приложение, созданное, чтобы проверять спеки .t27, которые меняет пулл-реквест. Для других репозиториев оно пока не открыто.", "SAY_CLAW_POST_PRESS": "Прочитать о TRI CLAW" } diff --git a/apps/website/public/agents.t27 b/apps/website/public/agents.t27 index 682d9ae194..df09423064 100644 --- a/apps/website/public/agents.t27 +++ b/apps/website/public/agents.t27 @@ -1,5 +1,5 @@ ; GENERATED by apps/website/scripts/onboarding-from-spec.mjs (gHashTag/trinity) -; from specs/catalog/onboarding.t27, sha256 ecfff5ef451ea616cc6b520fbfc5ba7b086672bc0e1d9c44d680a9d0fce9bc5d +; from specs/catalog/onboarding.t27, sha256 52ecb66d51bc8332b1002f222222af276f1deaf51ce30f4931bdacdac1c38953 ; Served as https://t27.ai/agents.t27 and https://t27.ai/llms.txt -- the same bytes at both addresses. ; Do not edit either file: edit the spec and re-run the generator. @@ -169,7 +169,7 @@ pub const HEALTH_PARTIAL : u16 = 169; ; own spec, so a count here would drift -- read the source for it. pub const COURSE : str = "https://t27.ai/learn/"; pub const COURSE_SOURCE : str = "https://t27.ai/learn/t27-basics.t27"; -pub const COURSE_NOTE : str = "Three courses of 27 lessons, free, no account: t27 basics at /learn/, then From zero to a chip, FPGA programming with t27, at /learn/course/, then AI numbers with t27 at /learn/ai-numbers/; Russian under /ru/learn/, one page per lesson listed in /learn/sitemap.xml"; +pub const COURSE_NOTE : str = "Every course is free, no account: t27 basics at /learn/, every other course at /learn// (the list is at /learn/), and each whole course on one page at its address plus all/ (t27 basics at /learn/all/); Russian under /ru/learn/, every page listed in /learn/sitemap.xml"; ; --- The game -------------------------------------------------------------------------------- pub const GAME : str = "Queen Hive"; diff --git a/apps/website/public/learn/a-bar-detector/index.html b/apps/website/public/learn/a-bar-detector/index.html index 516eab270c..c37e2c745e 100644 --- a/apps/website/public/learn/a-bar-detector/index.html +++ b/apps/website/public/learn/a-bar-detector/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-bend-at-zero/index.html b/apps/website/public/learn/a-bend-at-zero/index.html index f2d42edecf..b619836e06 100644 --- a/apps/website/public/learn/a-bend-at-zero/index.html +++ b/apps/website/public/learn/a-bend-at-zero/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-boundary-of-real-files/index.html b/apps/website/public/learn/a-boundary-of-real-files/index.html index a24003c3a5..e5dd8370d3 100644 --- a/apps/website/public/learn/a-boundary-of-real-files/index.html +++ b/apps/website/public/learn/a-boundary-of-real-files/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-build-receipt/index.html b/apps/website/public/learn/a-build-receipt/index.html index 1de041de9b..793558a9a4 100644 --- a/apps/website/public/learn/a-build-receipt/index.html +++ b/apps/website/public/learn/a-build-receipt/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-correlator-finds-the-frame/index.html b/apps/website/public/learn/a-correlator-finds-the-frame/index.html index 0b58302d18..f4945f0734 100644 --- a/apps/website/public/learn/a-correlator-finds-the-frame/index.html +++ b/apps/website/public/learn/a-correlator-finds-the-frame/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-deploy-mid-flight/index.html b/apps/website/public/learn/a-deploy-mid-flight/index.html index 91bb4774c8..3c35d4e458 100644 --- a/apps/website/public/learn/a-deploy-mid-flight/index.html +++ b/apps/website/public/learn/a-deploy-mid-flight/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-dot-product-in-wires/index.html b/apps/website/public/learn/a-dot-product-in-wires/index.html index bb33496e82..aae8bb143a 100644 --- a/apps/website/public/learn/a-dot-product-in-wires/index.html +++ b/apps/website/public/learn/a-dot-product-in-wires/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-float-cut-by-phi/index.html b/apps/website/public/learn/a-float-cut-by-phi/index.html index 9511a6c373..b700ba1e22 100644 --- a/apps/website/public/learn/a-float-cut-by-phi/index.html +++ b/apps/website/public/learn/a-float-cut-by-phi/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-key-rests/index.html b/apps/website/public/learn/a-key-rests/index.html index 5601ab6bee..0b83406749 100644 --- a/apps/website/public/learn/a-key-rests/index.html +++ b/apps/website/public/learn/a-key-rests/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-loss-in-bits/index.html b/apps/website/public/learn/a-loss-in-bits/index.html index 63b703dd28..e51c5620b5 100644 --- a/apps/website/public/learn/a-loss-in-bits/index.html +++ b/apps/website/public/learn/a-loss-in-bits/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-model-on-the-board/index.html b/apps/website/public/learn/a-model-on-the-board/index.html index 10d8b89fc3..ff8e0e315e 100644 --- a/apps/website/public/learn/a-model-on-the-board/index.html +++ b/apps/website/public/learn/a-model-on-the-board/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-neuron-in-chunks/index.html b/apps/website/public/learn/a-neuron-in-chunks/index.html index a3395b6f4d..b8b6fa7710 100644 --- a/apps/website/public/learn/a-neuron-in-chunks/index.html +++ b/apps/website/public/learn/a-neuron-in-chunks/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-pass-that-checked-nothing/index.html b/apps/website/public/learn/a-pass-that-checked-nothing/index.html index 53c8de1b41..fd5116a67e 100644 --- a/apps/website/public/learn/a-pass-that-checked-nothing/index.html +++ b/apps/website/public/learn/a-pass-that-checked-nothing/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-recurrent-cell/index.html b/apps/website/public/learn/a-recurrent-cell/index.html index 3f22a96c99..077fa8f482 100644 --- a/apps/website/public/learn/a-recurrent-cell/index.html +++ b/apps/website/public/learn/a-recurrent-cell/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-refused-key/index.html b/apps/website/public/learn/a-refused-key/index.html index 5648e8e090..aeffe6ba69 100644 --- a/apps/website/public/learn/a-refused-key/index.html +++ b/apps/website/public/learn/a-refused-key/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-sign-is-one-bit/index.html b/apps/website/public/learn/a-sign-is-one-bit/index.html index 1c80ed57eb..a54eaff779 100644 --- a/apps/website/public/learn/a-sign-is-one-bit/index.html +++ b/apps/website/public/learn/a-sign-is-one-bit/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-small-program/index.html b/apps/website/public/learn/a-small-program/index.html index 0de6177645..711eb97eb5 100644 --- a/apps/website/public/learn/a-small-program/index.html +++ b/apps/website/public/learn/a-small-program/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-tasks-life/index.html b/apps/website/public/learn/a-tasks-life/index.html index 0934d56aec..02e395d90a 100644 --- a/apps/website/public/learn/a-tasks-life/index.html +++ b/apps/website/public/learn/a-tasks-life/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-ternary-alu/index.html b/apps/website/public/learn/a-ternary-alu/index.html index c10d99371c..bdbbd329dd 100644 --- a/apps/website/public/learn/a-ternary-alu/index.html +++ b/apps/website/public/learn/a-ternary-alu/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-test-block/index.html b/apps/website/public/learn/a-test-block/index.html index 6e9b7cf5d6..e9ea7b32aa 100644 --- a/apps/website/public/learn/a-test-block/index.html +++ b/apps/website/public/learn/a-test-block/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-tiny-layer/index.html b/apps/website/public/learn/a-tiny-layer/index.html index f7b77e73ff..59c7f9372e 100644 --- a/apps/website/public/learn/a-tiny-layer/index.html +++ b/apps/website/public/learn/a-tiny-layer/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-whole-network/index.html b/apps/website/public/learn/a-whole-network/index.html index f20ece1a1f..6256dc5f1d 100644 --- a/apps/website/public/learn/a-whole-network/index.html +++ b/apps/website/public/learn/a-whole-network/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/a-word-of-27/index.html b/apps/website/public/learn/a-word-of-27/index.html index 6e51e78d2d..b1a8395ab3 100644 --- a/apps/website/public/learn/a-word-of-27/index.html +++ b/apps/website/public/learn/a-word-of-27/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/adam/index.html b/apps/website/public/learn/adam/index.html index 08c9ff411f..e0b93d5b21 100644 --- a/apps/website/public/learn/adam/index.html +++ b/apps/website/public/learn/adam/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/add-it-up-every-clock/index.html b/apps/website/public/learn/add-it-up-every-clock/index.html index 69d0f98e58..f28a42f2e1 100644 --- a/apps/website/public/learn/add-it-up-every-clock/index.html +++ b/apps/website/public/learn/add-it-up-every-clock/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/address-decode/index.html b/apps/website/public/learn/address-decode/index.html index 08a3793a59..69e7e5bbe5 100644 --- a/apps/website/public/learn/address-decode/index.html +++ b/apps/website/public/learn/address-decode/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/aging-a-label/index.html b/apps/website/public/learn/aging-a-label/index.html index 6ab0f5bca0..e78418909c 100644 --- a/apps/website/public/learn/aging-a-label/index.html +++ b/apps/website/public/learn/aging-a-label/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { diff --git a/apps/website/public/learn/ai-numbers/all/index.html b/apps/website/public/learn/ai-numbers/all/index.html index 376d9ecf62..fe88994035 100644 --- a/apps/website/public/learn/ai-numbers/all/index.html +++ b/apps/website/public/learn/ai-numbers/all/index.html @@ -46,6 +46,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -61,7 +62,7 @@ body { margin: 0; background: #000; color: #e6e6e6; font: var(--course-text-px)/1.65 'Outfit', system-ui, sans-serif; padding-bottom: calc(var(--course-thumb-bar) + env(safe-area-inset-bottom)); overflow-x: hidden; } a { color: #fff; text-underline-offset: 3px; text-decoration-color: #777; } a:hover { text-decoration-color: #fff; } -:focus-visible { outline: var(--course-focus-ring) solid #fff; outline-offset: 2px; } +:focus-visible { outline: var(--course-focus-ring) solid #fff; outline-offset: var(--course-focus-offset); } .op-label { display: block; font-size: 12px; letter-spacing: .16em; text-transform: uppercase; color: #a6a6a6; margin: 0 0 6px; } .op-head { display: flex; justify-content: space-between; align-items: center; max-width: var(--course-page-max); margin: 0 auto; padding: 0 var(--course-gutter-phone); border-bottom: 1px solid #1f1f1f; } .op-head a { display: inline-flex; align-items: center; min-height: var(--course-touch); padding: 0 6px; text-decoration: none; font-size: 15px; } @@ -81,7 +82,7 @@ .op-pill:hover { border-color: #fff; } .op-pill[aria-pressed="true"] { background: #fff; color: #000; border-color: #fff; } .op-cta { background: #fff; color: #000; border-color: #fff; font-weight: 600; } -.op-bar { display: grid; grid-template-columns: repeat(27, 1fr); gap: 3px; max-width: 760px; margin: 12px 0 6px; } +.op-bar { display: grid; grid-template-columns: repeat(27, 1fr); gap: 3px; max-width: var(--course-read); margin: 12px 0 6px; } .op-bar i { height: 6px; border-radius: 2px; background: #262626; } .op-bar i.is-done { background: #fff; } .op-bar i.is-here { background: #8a8a8a; } @@ -434,13 +435,13 @@

AI numbers with t27: from number formats to a ternary network

Contents
  1. 01 · Lab: our own research
    1. 01 T27: a number format of our own
    2. 02 An honest scoreboard
    3. 03 A model's tables on the board
  2. 02 · AI numbers: the MX block
    1. 04 One scale for a block of weights
    2. 05 The scale byte on a real machine
    3. 06 One outlier, many zeros
  3. 03 · Ternary weights
    1. 07 Weights of minus phi, zero and plus phi
    2. 08 A pass that checked nothing
    3. 09 Five rules for a weight alphabet
  4. 04 · The Ternary Network Float
    1. 10 Blocked is not failed
    2. 11 A float whose exponent is four trits
    3. 12 Negate twice, get the number back
  5. 05 · Arithmetic on signed numbers
    1. 13 A sign is one bit
    2. 14 Opposite signs subtract
    3. 15 Multiply, then add
  6. 06 · Parts of a neuron
    1. 16 A bend at zero
    2. 17 Two to the x
    3. 18 Pick the largest
  7. 07 · Learning from a mistake
    1. 19 A loss in bits
    2. 20 One step downhill
    3. 21 XOR needs a bend
  8. 08 · BitNet: ternary networks
    1. 22 Back to three values
    2. 23 Same neuron, new weights
    3. 24 A neuron in chunks
  9. 09 · The ternary MAC as a chip
    1. 25 A dot product made of wires
    2. 26 Add it up on every clock
    3. 27 A whole network
- + + + + + + + + + + + diff --git a/apps/website/public/ru/learn/a-bend-at-zero/index.html b/apps/website/public/ru/learn/a-bend-at-zero/index.html index a7bc90a147..d6d2058fb3 100644 --- a/apps/website/public/ru/learn/a-bend-at-zero/index.html +++ b/apps/website/public/ru/learn/a-bend-at-zero/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -124,7 +125,7 @@

Излом в нуле

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-boundary-of-real-files/index.html b/apps/website/public/ru/learn/a-boundary-of-real-files/index.html index 680cbaf322..35c40aba67 100644 --- a/apps/website/public/ru/learn/a-boundary-of-real-files/index.html +++ b/apps/website/public/ru/learn/a-boundary-of-real-files/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -230,7 +231,7 @@

Граница из настоящих файлов

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-build-receipt/index.html b/apps/website/public/ru/learn/a-build-receipt/index.html index bb2403467d..0da18e5ee7 100644 --- a/apps/website/public/ru/learn/a-build-receipt/index.html +++ b/apps/website/public/ru/learn/a-build-receipt/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -200,7 +201,7 @@

Сборка по пунктам

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-correlator-finds-the-frame/index.html b/apps/website/public/ru/learn/a-correlator-finds-the-frame/index.html index c9f3939ee0..883f4b2313 100644 --- a/apps/website/public/ru/learn/a-correlator-finds-the-frame/index.html +++ b/apps/website/public/ru/learn/a-correlator-finds-the-frame/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -314,7 +315,7 @@

Коррелятор находит кадр

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-deploy-mid-flight/index.html b/apps/website/public/ru/learn/a-deploy-mid-flight/index.html index a4f63fe475..5007ce7451 100644 --- a/apps/website/public/ru/learn/a-deploy-mid-flight/index.html +++ b/apps/website/public/ru/learn/a-deploy-mid-flight/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -421,7 +422,7 @@

Деплой на лету

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-dot-product-in-wires/index.html b/apps/website/public/ru/learn/a-dot-product-in-wires/index.html index 436626c9de..ff39af5346 100644 --- a/apps/website/public/ru/learn/a-dot-product-in-wires/index.html +++ b/apps/website/public/ru/learn/a-dot-product-in-wires/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -143,7 +144,7 @@

Скалярное произведение из проводов

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-float-cut-by-phi/index.html b/apps/website/public/ru/learn/a-float-cut-by-phi/index.html index b2b569a46f..5ceb61255c 100644 --- a/apps/website/public/ru/learn/a-float-cut-by-phi/index.html +++ b/apps/website/public/ru/learn/a-float-cut-by-phi/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -659,7 +660,7 @@

Число с плавающей точкой, разрезанное по p

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-key-rests/index.html b/apps/website/public/ru/learn/a-key-rests/index.html index 1220c1ae06..ff0f407e59 100644 --- a/apps/website/public/ru/learn/a-key-rests/index.html +++ b/apps/website/public/ru/learn/a-key-rests/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -483,7 +484,7 @@

Ключ отдыхает

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-loss-in-bits/index.html b/apps/website/public/ru/learn/a-loss-in-bits/index.html index 80cb809290..97ccecdcd3 100644 --- a/apps/website/public/ru/learn/a-loss-in-bits/index.html +++ b/apps/website/public/ru/learn/a-loss-in-bits/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -202,7 +203,7 @@

Потеря в битах

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-model-on-the-board/index.html b/apps/website/public/ru/learn/a-model-on-the-board/index.html index 5b701bfd0a..79910804ba 100644 --- a/apps/website/public/ru/learn/a-model-on-the-board/index.html +++ b/apps/website/public/ru/learn/a-model-on-the-board/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -346,7 +347,7 @@

Таблицы модели на плате

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-neuron-in-chunks/index.html b/apps/website/public/ru/learn/a-neuron-in-chunks/index.html index 84b01c887b..1c05a56ad9 100644 --- a/apps/website/public/ru/learn/a-neuron-in-chunks/index.html +++ b/apps/website/public/ru/learn/a-neuron-in-chunks/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -171,7 +172,7 @@

Нейрон по кускам

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-pass-that-checked-nothing/index.html b/apps/website/public/ru/learn/a-pass-that-checked-nothing/index.html index 1d87e73ce5..05c4b79262 100644 --- a/apps/website/public/ru/learn/a-pass-that-checked-nothing/index.html +++ b/apps/website/public/ru/learn/a-pass-that-checked-nothing/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -484,7 +485,7 @@

Прогон, который ничего не проверил

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-recurrent-cell/index.html b/apps/website/public/ru/learn/a-recurrent-cell/index.html index 07fe35dd19..4152ace494 100644 --- a/apps/website/public/ru/learn/a-recurrent-cell/index.html +++ b/apps/website/public/ru/learn/a-recurrent-cell/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -290,7 +291,7 @@

Рекуррентная ячейка

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-refused-key/index.html b/apps/website/public/ru/learn/a-refused-key/index.html index a98797a3a4..1c4c3ecf76 100644 --- a/apps/website/public/ru/learn/a-refused-key/index.html +++ b/apps/website/public/ru/learn/a-refused-key/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -483,7 +484,7 @@

Отклонённый ключ

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-sign-is-one-bit/index.html b/apps/website/public/ru/learn/a-sign-is-one-bit/index.html index 176c892e76..1d374a359b 100644 --- a/apps/website/public/ru/learn/a-sign-is-one-bit/index.html +++ b/apps/website/public/ru/learn/a-sign-is-one-bit/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -222,7 +223,7 @@

Знак — это один бит

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-small-program/index.html b/apps/website/public/ru/learn/a-small-program/index.html index 6614339232..0bd39fd3f8 100644 --- a/apps/website/public/ru/learn/a-small-program/index.html +++ b/apps/website/public/ru/learn/a-small-program/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -119,7 +120,7 @@

Маленькая законченная программа

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-tasks-life/index.html b/apps/website/public/ru/learn/a-tasks-life/index.html index 7ea72e0d6a..6899c6eaee 100644 --- a/apps/website/public/ru/learn/a-tasks-life/index.html +++ b/apps/website/public/ru/learn/a-tasks-life/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -694,7 +695,7 @@

Жизнь задачи

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-ternary-alu/index.html b/apps/website/public/ru/learn/a-ternary-alu/index.html index b52448a8d7..e917cb0dd2 100644 --- a/apps/website/public/ru/learn/a-ternary-alu/index.html +++ b/apps/website/public/ru/learn/a-ternary-alu/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -565,7 +566,7 @@

Троичное АЛУ

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-test-block/index.html b/apps/website/public/ru/learn/a-test-block/index.html index 49eae0fcd8..3623065d2a 100644 --- a/apps/website/public/ru/learn/a-test-block/index.html +++ b/apps/website/public/ru/learn/a-test-block/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -112,7 +113,7 @@

Блок test

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-tiny-layer/index.html b/apps/website/public/ru/learn/a-tiny-layer/index.html index 53c0d45e97..19a0be7ffe 100644 --- a/apps/website/public/ru/learn/a-tiny-layer/index.html +++ b/apps/website/public/ru/learn/a-tiny-layer/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -162,7 +163,7 @@

Маленький слой

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-whole-network/index.html b/apps/website/public/ru/learn/a-whole-network/index.html index e85d4d00f4..7d96a98782 100644 --- a/apps/website/public/ru/learn/a-whole-network/index.html +++ b/apps/website/public/ru/learn/a-whole-network/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -172,7 +173,7 @@

Целая сеть

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/a-word-of-27/index.html b/apps/website/public/ru/learn/a-word-of-27/index.html index 254b0da4f3..d0cdc2bbc3 100644 --- a/apps/website/public/ru/learn/a-word-of-27/index.html +++ b/apps/website/public/ru/learn/a-word-of-27/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -799,7 +800,7 @@

Слово из 27 тритов

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/adam/index.html b/apps/website/public/ru/learn/adam/index.html index c6a29309f5..34fcaebd6b 100644 --- a/apps/website/public/ru/learn/adam/index.html +++ b/apps/website/public/ru/learn/adam/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -257,7 +258,7 @@

Adam: момент и масштаб

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/add-it-up-every-clock/index.html b/apps/website/public/ru/learn/add-it-up-every-clock/index.html index ef82e4abd1..4b9913b20b 100644 --- a/apps/website/public/ru/learn/add-it-up-every-clock/index.html +++ b/apps/website/public/ru/learn/add-it-up-every-clock/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -152,7 +153,7 @@

Складывать на каждом такте

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/address-decode/index.html b/apps/website/public/ru/learn/address-decode/index.html index c3f84ad092..84bd6e203b 100644 --- a/apps/website/public/ru/learn/address-decode/index.html +++ b/apps/website/public/ru/learn/address-decode/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -258,7 +259,7 @@

Дешифрация адреса

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/aging-a-label/index.html b/apps/website/public/ru/learn/aging-a-label/index.html index eccc3e3555..67f8e5c960 100644 --- a/apps/website/public/ru/learn/aging-a-label/index.html +++ b/apps/website/public/ru/learn/aging-a-label/index.html @@ -66,6 +66,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -263,7 +264,7 @@

Старение метки

Открыть спеку урока в плеере ↗

Все уроки

- + diff --git a/apps/website/public/ru/learn/ai-numbers/all/index.html b/apps/website/public/ru/learn/ai-numbers/all/index.html index 4d0123bde1..6efe90a2cb 100644 --- a/apps/website/public/ru/learn/ai-numbers/all/index.html +++ b/apps/website/public/ru/learn/ai-numbers/all/index.html @@ -46,6 +46,7 @@ --course-touch: 44px; --course-thumb-bar: 56px; --course-focus-ring: 2px; + --course-focus-offset: 2px; } .course-page:lang(ru), .op-page:lang(ru) { @@ -61,7 +62,7 @@ body { margin: 0; background: #000; color: #e6e6e6; font: var(--course-text-px)/1.65 'Outfit', system-ui, sans-serif; padding-bottom: calc(var(--course-thumb-bar) + env(safe-area-inset-bottom)); overflow-x: hidden; } a { color: #fff; text-underline-offset: 3px; text-decoration-color: #777; } a:hover { text-decoration-color: #fff; } -:focus-visible { outline: var(--course-focus-ring) solid #fff; outline-offset: 2px; } +:focus-visible { outline: var(--course-focus-ring) solid #fff; outline-offset: var(--course-focus-offset); } .op-label { display: block; font-size: 12px; letter-spacing: .16em; text-transform: uppercase; color: #a6a6a6; margin: 0 0 6px; } .op-head { display: flex; justify-content: space-between; align-items: center; max-width: var(--course-page-max); margin: 0 auto; padding: 0 var(--course-gutter-phone); border-bottom: 1px solid #1f1f1f; } .op-head a { display: inline-flex; align-items: center; min-height: var(--course-touch); padding: 0 6px; text-decoration: none; font-size: 15px; } @@ -81,7 +82,7 @@ .op-pill:hover { border-color: #fff; } .op-pill[aria-pressed="true"] { background: #fff; color: #000; border-color: #fff; } .op-cta { background: #fff; color: #000; border-color: #fff; font-weight: 600; } -.op-bar { display: grid; grid-template-columns: repeat(27, 1fr); gap: 3px; max-width: 760px; margin: 12px 0 6px; } +.op-bar { display: grid; grid-template-columns: repeat(27, 1fr); gap: 3px; max-width: var(--course-read); margin: 12px 0 6px; } .op-bar i { height: 6px; border-radius: 2px; background: #262626; } .op-bar i.is-done { background: #fff; } .op-bar i.is-here { background: #8a8a8a; } @@ -424,7 +425,7 @@

ИИ-числа на t27: от форматов чисел до тернар