{"id":39537795,"url":"https://github.com/blabu/femtox","last_synced_at":"2026-01-18T06:34:30.043Z","repository":{"id":130206514,"uuid":"106089601","full_name":"blabu/femtox","owner":"blabu","description":"Simple operation system for microcontrolers","archived":false,"fork":false,"pushed_at":"2024-10-21T08:33:54.000Z","size":619,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2024-10-21T11:51:57.422Z","etag":null,"topics":["arm","avr","microcontroller","msp430"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blabu.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-07T10:31:16.000Z","updated_at":"2024-09-22T07:23:41.000Z","dependencies_parsed_at":"2024-10-21T11:47:03.533Z","dependency_job_id":null,"html_url":"https://github.com/blabu/femtox","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/blabu/femtox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blabu%2Ffemtox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blabu%2Ffemtox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blabu%2Ffemtox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blabu%2Ffemtox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blabu","download_url":"https://codeload.github.com/blabu/femtox/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blabu%2Ffemtox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28531997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arm","avr","microcontroller","msp430"],"created_at":"2026-01-18T06:34:29.973Z","updated_at":"2026-01-18T06:34:30.033Z","avatar_url":"https://github.com/blabu.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Femtox\n\n**\nМини фреймворк написаннный на ANCII C для работы с микроконтроллерами, соответсвует стандарту С99. С нулевыми зависимостями.\n**\n\nВозможности\n=============\nФреймворк представляет собой прототип кооперативной операционной системы. В котором реализваны следующие возможности:\n1. Очередь задач\n2. Очередь таймеров\n3. Подсистема сигналов и слотов\n4. Подсистема управления колбек функциями\n5. Система управления и выделения динамической памяти из заранее выделеной кучи\n6. Структуры данных стек, очередь (FIFO, FILO) и кольцевой буфер, связанный список\n7. Подсистема циклически выполняющихся задач\n\nВведение\n=============\nДля использования фреймворка необходимо define-ми выбрать архитектру в файле platform.h, для которой будет осуществлятся компиляция или, если необходимой архитектуры найдено не было, реализовать платфомо-зависимые функции по примеру файла PlatformSpecific?????.h.\nПоддерживаемые архитектуры:\n1. AVR\n2. MSP430\n3. STM32\n4. X86 (из под Linux) - может использоватся как мини фреймворк\n5. X86 (из под Windows)  - может использоватся как мини фреймворк\n\nДля тонкой настройки фреймворка под заданные нужды существуют файлы FemtoxConf????.h.\nВ файлах FemtoxTypes???.h - определены типы данных используемые в библиотеки.\n\nПример использования: минимальный рабочий код.\n-------------\n\n```c\n#include \"TaskMng.h\"\n#include \"PlatformSpecific.h\"\n\nint main() {\ninitFemtOS();\nrunFemtOS();\nreturn 0;\n}\n```\n\u003ccode\u003einitFemtOS()\u003c/code\u003e - инициализирует все подсистемы настроенные в файле FemtoxConf????.h. \n\u003ccode\u003erunFemtOS()\u003c/code\u003e - запустит цикл обработки всех подсистем.\nУказанный выше код не выполняет никаких полезных функций.\nРасмотрим еще пример:\n\nПример использования: выполняем одну задачу.\n-------------\nЗадачей является любая функция со следующей сигнатурой:\n\u003ccode\u003evoid taskName(BaseSize_t arg_n, BaseParam_t arg_p);\u003c/code\u003e\n\n```c\n#include \"TaskMng.h\"\n#include \"PlatformSpecific.h\"\n\nvoid someVeryImportantTask(BaseSize_t arg_n, BaseParam_t arg_p) {\n\t// Do many important things\n\tSetTimerTask(someVeryImportantTask,arg_n, arg_p,10);\n}\n\nint main() {\ninitFemtOS();\nSetTask(someVeryImportantTask,arg_n, arg_p);\nrunFemtOS();\nreturn 0;\n}\n```\nВ коде выше функция \u003ccode\u003evoid someVeryImportantTask(BaseSize_t arg_n, BaseParam_t arg_p)\u003c/code\u003e\nбудет выполнена сразу после вызова \u003ccode\u003erunFemtOS()\u003c/code\u003e\nПо завершению выполнения этой функции будет запущен таймер для запуска ее же через 10 тиков операционной системы.\nПосле чего, процесс повторится, и так до бесконечности.\nКод выше можно упростить с приминением подсистема циклически выполняющихся задач:\n\n```c\n#include \"TaskMng.h\"\n#include \"PlatformSpecific.h\"\n\nvoid someVeryImportantTask() {\n\t// Do many important things\n}\n\nint main() {\ninitFemtOS();\nSetCycleTask(10, someVeryImportantTask,TRUE);\nrunFemtOS();\nreturn 0;\n}\n```\nАналогично предыдущему, функция \u003ccode\u003evoid someVeryImportantTask()\u003c/code\u003e будет вызыватся каждые 10 тактов операционной системы.\n\nПример использования: подсистема колбек-ов.\n-------------\n\nКолбэк - это отложеный вызов функции по завершению какой-либо задачи.\nНа одну регистрацию колбека будет вызван один раз колбэк.\n```c\n#include \"TaskMng.h\"\n#include \"PlatformSpecific.h\"\n\nvoid someVeryImportantTask(BaseSize_t count, BaseParam_t argPtr) {\n\tswitch(count) {\n\tcase 0:\n\t\t// Do some prepare stuff\n\t\tcount++;\n\t\tSetTimerTask(someVeryImportantTask,count,argPtr,20); // Back here later\n\t\treturn;\n\tcase 1:\n\t\t// Do some another stuff\n\t\tif(argPtr == NULL) count=10;\n\t\telse count = 20;\n\t\tSetTimerTask(someVeryImportantTask,count,argPtr,100); // Back here later\n\t\treturn;\n\tcase 10:\n\t\t// Do some stuff\n\t\tcount = 2;\n\t\tSetTask(someVeryImportantTask,count,argPtr); \n\tcase 20:\n\t\t// Do some stuff\n\t\tcount = 2;\n\t\tSetTask(someVeryImportantTask,count,argPtr); \n\tcase 2:\n\t\t// Finish some\n\t\tcount = 0xFF;\n\t\tSetTask(someVeryImportantTask,count,argPtr); //Call task as quickly as you can\n\t\treturn;\n\tdefault:\n\t\texecCallBack((void*)someVeryImportantTask); // Задача завершилась, сообщим об этом всем\n\t\treturn;\n\t}\n}\n\nvoid waitSomeTask(BaseSize_t argN, BaseParam_t argPtr) {\n\t// Do some\n}\n\nint main() {\ninitFemtOS();\nregisterCallBack(waitSomeTask,0,NULL,someVeryImportantTask);\n// По завершению этой задачи будет вызван waitSomeTask с указанными выше параметрами\nSetTask(someVeryImportantTask,0,NULL);\n// По заверению этой задачи ничего вызвано не будет так как новый колбэк не зарегистрирован\nSetTimerTask(someVeryImportantTask,0,NULL,BIG_TIME_DELAY);\nrunFemtOS();\nreturn 0;\n}\n```\nПример использования: подсистема сигналов.\n-------------\n\nДля реализации патерна издатель-подписчик хорошо подойдет подсистема сигналов\n\n```c\n#include \"TaskMng.h\"\n#include \"PlatformSpecific.h\"\nvoid* someVeryImportantSignal = (void*)10; // Здесь может быть что угодно (это лишь метка)\nvoid someVeryImportantTask(BaseSize_t count, BaseParam_t argPtr) {\n\tswitch(count) {\n\tcase 0:\n\t\t// Do some prepare stuff\n\t\tcount++;\n\t\tSetTimerTask(someVeryImportantTask,count,argPtr,20); // Back here later\n\t\treturn;\n\tcase 1:\n\t\t// Do some another stuff\n\t\tif(argPtr == NULL) count=10;\n\t\telse count = 20;\n\t\tSetTimerTask(someVeryImportantTask,count,argPtr,100); // Back here later\n\t\treturn;\n\tcase 10:\n\t\t// Do some stuff\n\t\tcount = 2;\n\t\tSetTask(someVeryImportantTask,count,argPtr); \n\tcase 20:\n\t\t// Do some stuff\n\t\tcount = 2;\n\t\tSetTask(someVeryImportantTask,count,argPtr); \n\tcase 2:\n\t\t// Finish some\n\t\tcount = 0xFF;\n\t\tSetTask(someVeryImportantTask,count,argPtr); //Call task as quickly as you can\n\t\treturn;\n\tdefault:\n\t\temitSignal(someVeryImportantSignal, count, argPtr); // Генерируем сигнал с параметрами\n\t\treturn;\n\t}\n}\n\nvoid waitSomeTask(BaseSize_t argN, BaseParam_t argPtr) {\n\t// Do some\n}\n#define BIG_TIME_DELAY 0xFFFF0\nint main() {\ninitFemtOS();\nconnectTaskToSignal(waitSomeTask, someVeryImportantSignal);\n // По завершению задачи будет создан сигнал и вызвана функция waitSomeTask\nSetTask(someVeryImportantTask,0,NULL);\n// Через заданное время сново будет создан сигнал и вызвана функция waitSomeTask\nSetTimerTask(someVeryImportantTask,0,NULL,BIG_TIME_DELAY);\nrunFemtOS();\nreturn 0;\n}\n```\nЛицензия\n-------------\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblabu%2Ffemtox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblabu%2Ffemtox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblabu%2Ffemtox/lists"}