FreeRTOS: избранные главы. Перевод документации.

Hobby's category:

Перевод может содержать ошибки. Читайте первоисточник: The FreeRTOS™ Kernel

Последнее обновление: 20240904

Здесь не планируется обучающего курса по основам FreeRTOS и RTOS в целом. По крайней мере, пока. Чтобы изучить основы, можно взять например прекрасную книжку на основе статей, которые написал Андрей Курниц. Несмотря на то, что этим статьям уже семь лет, основные принципы не изменились, и книжка по-прежнему актуальна. Кроме того, в сети есть масса других обучающих статей. Навскидку: на изиэлектрониксе, на хабре, на микросине. Но пока нигде не нашёл переведённого описания новых фишек, появившихся в версиях 9 и 10 FreeRTOS. Поэтому за основу взял site map родного сайта FreeRTOS и начал перевод некоторых глав. Но здесь уже есть и некоторые дополнительные страницы, которых нет в карте оригинального сайта. Примечание 20240812: после перелицовки на оригинальном сайте страничка "site map", увы, исчезла.

Ссылки на статьи, перечисленные чуть выше, есть на странице "Книги и руководства по FreeRTOS".

Этот перевод выполняется "с нуля", чтобы не терять смысла, вложенного в текст разработчиками FreeRTOS. Также при переводе не используются каки-либо иные уже переведённые русскоязычные тексты. Те страницы, которые совсем не интересны, либо оригинальная страница пуста, либо является дублирующей - постепенно выкидываются из списка. А что нужно - постепенно переводятся и заменяются ссылками на локальные. Изначально делается перевод "в лоб", страница-в-страницу. Если остаются места с не до конца понятным смыслом или совсем исковерканным русским языком, текст помечается оранжевым фоном. Литературная обработка ещё предстоит. Сначала просто перевод.

Заранее отвечу на вопрос: "Будет ли перевод выложен одним pdf-файлом?" Вполне возможно. Если посчитаю, что перевод завершён, хотя бы в части описания ядра FreeRTOS. Но не стоит на это рассчитывать, т.к. на сегодняшний день его просто не существует.

Копирование к себе любой части перевода только приветствуется. При этом ссылка на данную страницу будет не лишней, т.к. содержимое всё ещё добавляется. Только будьте внимательны: после того, как перевод основных частей будет закончен, структура адресов страниц немного изменится. Страница по этому адресу - точно сохранится. Внимание! Никакой ответственности за предоставленные материалы, за точность и корректность переводов и всё остальное администрация сайта и авторы перевода не несут. Всё, что вы делаете (или не делаете), вы делаете (или не делаете) на свой страх и риск, и исключительно под свою ответственность.

В тексте имена файлов и каталогов выделены курсивом.

ToDo:

Перевести текст на иллюстрациях.
Как правильнее: "настройка в файле конфигурации" или "константа в файле конфигурации"? Или вообще по-другому назвать...
Скорректировать ссылки, в т.ч. "вперёд" и "назад".

Home - Начало /переведено/
Глоссарий
FreeRTOS Books and Manuals - Книги и руководства по FreeRTOS /переведено/
FreeRTOS /та же ссылка, что и двумя строками ниже/
- About FreeRTOS /а эта тоже является копией ссылки строчкой ниже/
  - What is an RTOS/FreeRTOS? /переведено/ /требуются уточнения/
  - A Compelling Free Solution /переведено/
  - A Better Type of Open Source - Лучший тип ПО с открытым исходным кодом /переведено/
  - Features Overview - Обзор характеристик /переведено/
  - Coding Standard & Style / MISRA / Testing /переведено/
  - Licensing /переведено/
  - Site Map /эта страница была взята в качестве основы для данного оглавления/
- Features / Getting Started... /та же ссылка, что и строчкой ниже/
  - Quick Start Guide - Руководство по быстрому старту /переведено/
  - Tasks & Co-routines - Задачи и сопрограммы /переведено/
  - More About Tasks... /ничего интересного, только четыре ссылки на следующие страницы и ссылка на страницу с книжкой/
    - Task States - Состояния задачи /переведено/
    - Task Priorities - Приоритеты задачи /переведено/, /требуются уточнения/
    - Implementing a Task - Реализация задачи /переведено/
    - Idle Task and Idle Hook - Задача простоя и ловушка задачи простоя /переведено/, /требуются уточнения/
  - More About Co-routines... /ничего интересного, только семь ссылок на следующие страницы/
    - Co-routine Status - Состояния сопрограммы /переведено/
    - Co-routine Priorities - Приоритеты сопрограммы /переведено/
    - Implementing a Co-routine - Реализация сопрограммы /переведено/
    - Scheduling Co-routines - Планирование сопрограмм /переведено/
    - Limitations and Restrictions - Ограничения и ограничения :) /переведено/
    - Quick Co-routine Example - Быстрый пример сопрограммы /переведено/
    - Standard Demo Examples - Примеры использования сопрограмм в стандартных демонстрационных приложениях /переведено/
  - Queues, Mutexes, Semaphores... - Межзадачное взаимодействие и синхронизация /переведено/
    - Queues - очереди /требуются уточнения/
    - Binary Semaphores - бинарные семафоры /переведено/
    - Counting Semaphores - счётные семафоры /переведено/
    - Mutexes - мьютексы /переведено/
    - Recursive Mutexes - рекурсивные мьютексы /переведено/
    - Direct To Task Notifications - Уведомления /переведено/
      - ...As Binary Semaphore - ...В качестве бинарных семафоров /переведено/
      - ...As Counting Semaphore - ...В качестве счётных семафоров /переведено/
      - ...As Event Group - ...В качестве группы флагов /переведено/, /требуются уточнения/
      - ...As Mailbox - ...В качестве почтового ящика /переведено/
    - Event Groups (or 'flags') - Флаги /переведено/, /требуются уточнения/
    - Stream & Message Buffers - Буферы потоков и сообщений /переведено/
      - Подробнее о буферах потока... /переведено/, /требуются уточнения/
      - Подробнее о буферах сообщений... /переведено/
  - Software Timers - таймеры во FreeRTOS /переведено/
    - Введение (совпадает с "Software Timers - таймеры во FreeRTOS") /переведено/
    - Timer Service Daemon Task- сервисная задача таймеров /переведено/ /требуются уточнения/
    - Timer Daemon Configuration /переведено/
    - One-Shot Vs Auto-Reload /переведено/
    - Resetting a Timer /переведено/
  - Source Code Organization /переведено/
- More Advanced... Более подробно... /не перевожу, т.к. "Макросы трассировки" - это она же/
  - Creating a New Project - Создание нового проекта /переведено/
  - FreeRTOSConfig.h /переведено/ - страница оказалась сложной. /требуется несколько уточнений/
  - Trace Features - Макросы трассировки /переведено/ /требуются дополнения, т.к. в оригинале описаны не все макросы/
  - Low Power Support /переведено/ /требуются мелкие уточнения/
  - Run Time Stats - Статистика времени выполнения /переведено/ /требуются мелкие уточнения/
  - Blocking on Multiple Objects /переведено/ /угадал все буквы, не смог назвать слово/
  - Deferred Interrupt Handling - Отложенная обработка прерываний /переведено/ /требуются мелкие уточнения/
  - Static Vs Dynamic Memory - Статическое или динамическое выделение памяти. /переведено/
  - Memory Management - Управление памятью /переведено/, /требуются мелкие уточнения/
  - Memory Protection Unit (MPU) Support /переведено/, /требуются мелкие уточнения/
  - Stack Overflow Protection - Использование стека и обнаружение переполнения стека /переведено/
  - Hook Functions - Функции-ловушки /переведено/, /нужно уточнить ссылку на описание демки/
  - Thread Local Storage Pointers /переведено/, /есть косяки русский языка/
  - How FreeRTOS Works - как работает FreeRTOS
    - Introduction - Введение /переведено/
    - Fundamentals - основы /переведено/
      - Multitasking Basics - основы многозадачности /переведено/
      - Scheduling Basics - основы работы планировщика /переведено/
      - Context Switching - Переключение контекста /переведено/
      - Real Time Applications /переведено/
      - Real Time Scheduling /переведено/
    - Implementation - реализация /переведено/
      - Building Blocks /не перевожу, т.к. там только дублирующий набор ссылок на страницы этого раздела/
        Development Tools - средства разработки /переведено/
        
        The RTOS Tick /переведено/
        
        GCC Signal Attribute /переведено/
        
        GCC Naked Attribute /переведено/
        
        FreeRTOS Tick Code /переведено/
        
        AVR Context /переведено/
        
        Saving the Context /переведено/
        
        Restoring the Context /переведено/
      - Detailed Example /не перевожу, т.к. там только дублирующий набор ссылок на страницы этого раздела/
        Putting It All Together /переведено/
        
        Step 1 /переведено/
        
        Step 2 /переведено/
        
        Step 3 /переведено/
        
        Step 4 /переведено/
        
        Step 5 /переведено/
        
        Step 6 /переведено/
        
        Step 7 /переведено/
  - RAM Constrained Design Tips /не перевожу, т.к. следующая страница - та же самая/
    - Page 1 - Real Time Application Design Tutorial /переведено/
    - Page 2 - Solution 1 - Решение №1: Зачем использовать ядро ОСРВ? /переведено/
    - Page 3 - Solution 2 - Решение №2: Полностью вытесняющая система /переведено/
    - Page 4 - Solution 3 - Решение №3: Сокращение используемого объёма ОЗУ /переведено/
    - Page 5 - Solution 4 - Решение №4: Снижение нагрузки на процессор /переведено/
  - Porting Guide - Руководство по портированию /переведено/
  - Windows Simulator - /в работе/
  - Posix/Linux Simulator
  - Legacy Trace Facility
- Demo Projects
- Supported Devices & Demos
  - Official & Contributed Definitions
  - Simple List of Ports
  - Running the RTOS on a ARM Cortex-M Core /в работе/
  - Officially Supported Demos
  - TCP/IP Demos
- ИПП
  - PDF Reference Manual
  - Task Creation /не перевожу, т.к. там только дублирующий набор ссылок на страницы этого раздела/
    - TaskHandle_t (type) /переведено/
    - xTaskCreate() /переведено/
    - xTaskCreateStatic() /переведено/
    - xTaskCreateRestricted() - На сайте FreeRTOS она находится в разделе FreeRTOS-MPU Specific. Но логически здесь должна быть ссылка.
    - xTaskCreateRestrictedStatic() /переведено/
    - vTaskDelete() /переведено/
  - Task Control
    - vTaskDelay() /переведено/
    - vTaskDelayUntil() /переведено/
    - uxTaskPriorityGet() /переведено/
    - vTaskPrioritySet() /переведено/
    - vTaskSuspend() /переведено/
    - vTaskResume() /переведено/
    - xTaskResumeFromISR() /переведено/
    - xTaskAbortDelay() /переведено/
  - Task Utilities
  - RTOS Kernel Control
  - Direct To Task Notifications
  - Queues /в работе/
    - xQueueCreate() /переведено/
    - xQueueCreateStatic() /переведено/
    - vQueueDelete() /переведено/
    - xQueueSend() /переведено/
    - xQueueSendFromISR() /переведено/
    - xQueueSendToBack() /переведено/
    - xQueueSendToBackFromISR() /переведено/
    - xQueueSendToFront() /переведено/
    - xQueueSendToFrontFromISR() /переведено/
    - xQueueReceive() /переведено/
    - xQueueReceiveFromISR /переведено/
    - uxQueueMessagesWaiting /переведено/
    - uxQueueMessagesWaitingFromISR /переведено/
    - uxQueueSpacesAvailable /переведено/
    - xQueueReset /переведено/
    - xQueueOverwrite /переведено/
    - xQueueOverwriteFromISR /переведено/
    - xQueuePeek /переведено/
    - xQueuePeekFromISR /переведено/
    - vQueueAddToRegistry /переведено/
    - vQueueUnregisterQueue /переведено/
    - pcQueueGetName /переведено/
    - xQueueIsQueueFullFromISR /переведено/
    - xQueueIsQueueEmptyFromISR /переведено/
    - xQueueGetStaticBuffers /переведено/
  - Queue Sets - Наборы очередей /переведено/
    - xQueueCreateSet /переведено/
    - xQueueAddToSet() /переведено/
    - xQueueRemoveFromSet() /переведено/
    - xQueueSelectFromSet() /переведено/
    - xQueueSelectFromSetFromISR /переведено/
  - RTOS stream buffer API functions:
    - xStreamBufferCreate /переведено/
    - xStreamBufferCreateWithCallback /переведено/ /желательно дополнить, см. примечание в конце той страницы/
    - xStreamBufferCreateStatic /в работе/
    - xStreamBufferCreateStaticWithCallback /в работе/
    - xStreamBufferSend()
    - xStreamBufferSendFromISR()
    - xStreamBufferReceive()
    - xStreamBufferReceiveFromISR()
    - vStreamBufferDelete()
    - xStreamBufferBytesAvailable()
    - xStreamBufferSpacesAvailable()
    - xStreamBufferSetTriggerLevel()
    - xStreamBufferReset()
    - xStreamBufferIsEmpty()
    - xStreamBufferIsFull()
  - RTOS message buffer API functions:
  - Semaphore / Mutexes
  - Software Timers
  - Event Groups (or 'flags')
  - FreeRTOS-MPU Specific
  - Co-routines
- Contact, Support, Advertising

Main menu

Navigation

Радиоэлектроника

You are here

FreeRTOS: избранные главы. Перевод документации.

Main menu

Navigation

User login

Радиоэлектроника

You are here

FreeRTOS: избранные главы. Перевод документации.