Цель урока: настроить всё необходимое, чтобы создавать, тестировать и отлаживать аддоны без лишних усилий.

Дисклеймер. На pikabu нет редактора кода, поэтому код картинками, но в конце я дам ссылку на github, откуда можно будет скопировать блоки кода.

🔧 Шаг 1. Убедитесь, что у вас установлен FreeCAD

Требования:

• FreeCAD версии 0.20 или новее (лучше 1.0+)

• Работает на Windows, Linux или macOS

👉 Если у вас ещё нет FreeCAD — скачайте его с официального сайта:
🔗 https://www.freecad.org/downloads.php

Выберите:

• Windows: .exe (установщик) или .7z (portable)

• Linux: AppImage или пакет из репозитория

• macOS: .dmg

💡 Совет: для обучения лучше использовать установленную версию (через установщик), так как она стабильнее и проще в настройке.

📁 Шаг 2. Найдите папку для аддонов

FreeCAD ищет пользовательские аддоны в специальной папке Mod.
Путь зависит от вашей ОС и типа установки.

✅ Как найти папку точно?

1. Запустите FreeCAD.

2. Откройте Python Console:
   View → Panels → Python console

3. Введите команды:

> import FreeCAD
> print(FreeCAD.getUserAppDataDir())

1. Нажмите Enter.

Вы увидите путь, например:

• Windows (установленная версия):
  C:\Users\ВашеИмя\AppData\Roaming\FreeCAD\

• Windows (portable):
  D:\FreeCAD\data\

• Linux:
  /home/ваше_имя/.local/share/FreeCAD/

• macOS:
  /Users/ваше_имя/Library/Application Support/FreeCAD/

➕ Создайте папку Mod

Внутри этой директории должна быть папка Mod.
Если её нет — создайте вручную.

Пример для Windows:

C:\Users\ВашеИмя\AppData\Roaming\FreeCAD\Mod\

💡 Быстрый способ открыть папку на Windows:
Нажмите Win + R → введите %APPDATA%\FreeCAD → Enter

🖥 Шаг 3. Настройте текстовый редактор (опционально, но очень рекомендуется)

Хотя можно писать код в Блокноте, удобнее использовать редактор с:

• Подсветкой синтаксиса Python

• Автодополнением

• Возможностью запуска скриптов

🔹 Рекомендую: Visual Studio Code (VS Code)

1. Скачайте и установите: https://code.visualstudio.com/

2. Установите расширение Python (от Microsoft)

🔹 Как открыть папку аддона в VS Code?

1. Запустите VS Code

2. File → Open Folder

3. Выберите папку Mod (или отдельный аддон внутри неё)

Теперь вы видите структуру проекта и можете редактировать файлы с комфортом.

🛠 Шаг 4. Изучите встроенные инструменты FreeCAD

FreeCAD уже содержит всё, что нужно для разработки.

1. Python Console

• Меню: View → Panels → Python console

• Позволяет выполнять команды в реальном времени

• Пример: введите App.newDocument() → создастся новый документ

2. Report View

• Меню: View → Panels → Report view

• Показывает ошибки, предупреждения, логи

• Обязательно держите открытым при тестировании аддона!

3. Macro Recorder

• Меню: Macro → Macros...

• Кнопка Record — записывает ваши действия в Python-код

• Отличный способ изучить API FreeCAD

💡 Попробуйте:

1. Нажмите Macro → Start recording

2. Создайте коробку (Part → Box)

3. Остановите запись

4. Откройте макрос — вы увидите реальный код создания объекта.

🧪 Шаг 5. Проверка: создайте тестовую папку

Чтобы убедиться, что всё работает:

1. В папке Mod создайте подпапку:

   TestAddon

2. Внутри создайте файл __init__.py (может быть пустым) — это говорит Python, что папка — модуль.

3. Перезапустите FreeCAD.

4. Откройте Report view.

Если вы не видите ошибок — значит, FreeCAD успешно сканирует папку Mod.

❗ Если появится ошибка вида ImportError — проверьте:

• Правильность имени папки (без пробелов и кириллицы)

• Наличие __init__.py (в новых версиях не всегда обязательно, но безопаснее добавить)

🗂 Структура папки разработчика (итог)

К концу этого урока у вас должна быть такая структура:

И вы знаете:

• Где лежит Mod

• Как открыть Python Console и Report View

• Как использовать Macro Recorder

• Как настроить VS Code (опционально)

✅ Практическое задание

1. Найдите папку Mod через FreeCAD.getUserAppDataDir()

2. Создайте папку MyFirstAddon внутри Mod

3. Добавьте в неё пустой файл __init__.py

4. Перезапустите FreeCAD

5. Убедитесь, что в Report view нет ошибок

🎯 Цель: FreeCAD должен запуститься без ошибок и "увидеть" вашу папку.

▶️ Что дальше?

В Уроке 2 мы создадим рабочий аддон:

• Добавим кнопку

• Сделаем, чтобы она что-то делала

• Научимся регистрировать команды и рабочие среды

  
  Понравилось — ставь «+»
  Полезно? Подпишись.
  Так я буду знать, какой контент вам интересен.
  Вопросы можно задавать в комментариях 👇👇👇
  Удачи! 🚀

Статья на github: https://github.com/hypo69/1001-python-ru/blob/master/ru/articles/FreeCAD/урок 1. Подготовка среды разработки.md

Мой молодой человек (24 года) безумно увлечён робототехникой. Это не просто хобби «посмотреть YouTube» — он реально покупает моторы, сам чертит и печатает детали на 3D-принтере, собирает манипуляторы, искусственные мышцы, программирует их, тестирует… У него дома что-то типа мини-лаборатории.

Но знаете, что самое грустное? Он в этом практически один.

Друзья и знакомые либо «вообще не в теме», либо считают это чем-то детским или странным. А ему очень не хватает живого общения с такими же увлечёнными. Чтобы не просто по форумам шариться, а как в детстве — прийти куда-то, показать свои наработки, вдохновиться чужими, обсудить идеи, вместе что-то делать.

Не курсы, не лекции. А именно тусовку, сообщество, где взрослые люди занимаются роботами, мехатроникой, инженерными поделками для души.

Вопрос: есть ли в Санкт-Петербурге такие кружки, клубы, мастерские, где собираются взрослые технари/робототехи? Что-то вроде открытых лабораторий?

Если вы знаете такое место — пожалуйста, поделитесь. Это будет для него реально ценно. А может, вы сами такой же и тоже ищете «своих»?

P.S. Если кто-то хочет собраться маленьким кругом где-нибудь и обсудить железки, проекты и платы — он будет только рад! :)

линукс с хфсе, иногда пользую mate и
конфигурация как я уже написал. оно не реактивное, но ничо не виснет, могу 20 вкладок браузера открыть, рендерить 3д. и +2 очееди копирования .

частоту меньше и 2 ядра, 4гб пробовал лично
на ноутбуке Ноутбук HP Compaq cq57 -- просмотр онлайн видео 1080р тормозит. обрабатывать небольшие документы, рисунки годится. NAS будет тормозить когда захочешь несколько очередей синхронизации запустить.

если кому-то интересно могут заглянуть в мой профиль, чтобы пообщаться персонально.

Давно читаю Пикабу и вот решился написать.

Я знаю, что многие родители заботясь о своих детях отправляют их в разные кружки робототехники и там они что-то программируют, мастерят. И это хорошо и правильно. Что сделано своими руками всегда идёт в пользу.

Я тут тоже кое-что "изобрёл" и хочу поделиться - это простое шасси для машинки Марсохода. Шасси это рама, колеса, крепления плат, моторчиков, бокса для блока питания.

Файлы 3D моделей всех деталей можно скачать на гитхабе . Всё в свободном доступе. Там же есть исходные дизайн файлы в среде FreeCAD 1.0 - что-то можно исправить или добавить если потребуется. Машинку легко собрать и запустить на ней простые, но надеюсь интересные проекты, о них читайте далее.

Все эти детали можно напечатать дома пластиком PLA на 3D принтере, печатать можно без поддержек и почти без пост обработки. Для сборки потребуется немного винтов М3 и гаек, шаговые моторчики 28BYJ-48 на 5 вольт, и маленький PowerBank для питания машинки, ну или бокс для батареек.

Плату управления можно поставить хоть Ардуино, хоть Raspberry. Я использую платы с ПЛИС типа MA3128 или Марсоход3GW2, но это уже дело десятое, как и что вы будете программировать. Главное это универсальное шасси машинки, которое можно использовать для разных учебных проектов.

Собрать машинку очень легко:

Шасси очень простое по трёхколёсной схеме с двумя управляющими моторчиками на заднем приводе. Переднее колесо с автоповоротом, так что руление просто осуществить меняя направления вращения задних колёс.

Что делать с такой машинкой? Это зависит от вашей фантазии и фантазии ваших детей.

У меня есть три простых проекта, которые можно повторить, но уверен, что их можно придумать гораздо больше.

1) Если машинку снабдить оптическими датчиками, то она может ездить по полосе:

2) Если на машинку поставить микросхему приёма IR сигнала, то машинкой можно управлять с пульта от телевизора Самсунг.

3) А можно на машинку установить смартфон с Андроид и управлять ею дистанционно по WiFi с ноутбука

Я надеюсь, что мои простые проекты будут интересны школьникам и студентам - будущим инженерам.