Отладка интерпретатора в Visual Studio Code

Для отладки собственных интерпретаторов G-кода на основе .NET (C#) необходимо выполнить следующие действия:

  1. Скачать и установить последнюю доступную версию Visual Studio Code ( https://code.visualstudio.com/download , размер ~ 90 Мб).

  2. Установить расширение C# for Visual Studio Code из магазина расширений Visual Studio Code (https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp).
    images/download/attachments/113361543/C__for_Visual_Studio_Code_link.png

  3. После нажатия на кнопку Install откроется VS Code (сокращение от Visual Studio Code ) на вкладке Расширения. Просто нажмите кнопку Install рядом с названием расширения.
    images/download/attachments/113361543/C__for_Visual_Studio_Code_Installation.png

  4. Для более удобного редактирования snci файлов рекомендуется (но не обязательно) установить расширение XML Language Support by Red Hat (https://marketplace.visualstudio.com/items?itemName=redhat.vscode-xml).

  5. Если вы еще этого не сделали, необходимо скачать и установить последнюю версию СПРУТКАМ (требуется версия 17 или выше) с официального сайта (https://sprut.ru/download).

  6. Далее нужно запустить СПРУТКАМ и выбрать пункт Создать интерпретатор УП в меню утилит.

    images/download/attachments/113361543/CreateInterpreter_En.png
  7. В появившемся окне требуется нажать кнопку Set SprutCAM X file path и задать путь к файлу sc.exe, расположенному в каталоге установки СПРУТКАМ (по умолчанию это "C:\Program Files\SprutCAM Tech\SprutCAM X 17\Bin64\sc.exe").
    images/download/attachments/113361543/InterpretersCreatingWizard_En.png
    Этот процесс добавляет переменную среды "SprutCAM_NCKernelDir" в переменные среды окружения Windows. Чтобы можно было запустить Visual Studio Code из СПРУТКАМ, переменная среды "Path" должна включать папку установки VS Code. Обычно установщик Visual Studio Code добавляет её по умолчанию.

    Для вступления в силу изменений в настройках переменных среды окружения Windows, рекомендуется перезагрузить компьютер после задания пути к исполняемому файлу sc.exe и окончания установки VS Code.

  8. Затем снова запустите СПРУТКАМ и выберите пункт Создать интерпретатор УП в меню утилит. Теперь вы можете создать новый интерпретатор, задав его имя в поле Наименование и директорию в поле Каталог, в котором будет создана папка, соответствующая имени интерпретатора, со всеми необходимыми исходными файлами.

  9. После нажатия кнопки <Да>, откроется новое окно Visual Studio Code с открытой вкладкой главного исходного файла интерпретатора Interpreter.cs.

    images/download/attachments/113361543/Interpreter.cs_En.png
  10. Потом вы можете установить точку останова на любом методе (например, конструкторе класса TInterpreter), переключиться на вкладку "Run and Debug" и нажать на кнопку "Launch SprutCAM" (клавиша F5).

    images/download/attachments/113361543/DebugInterpreter_En.png
  11. В результате запустится сборка интерпретатора из исходников, запустится СПРУТКАМ и начнётся отладка исходного кода.

  12. Для проверки работы интерпретатора необходимо создать операцию на основе текста УП в открывшемся окне СПРУТКАМ.

    images/download/attachments/113361543/GCodeBasedOperation_En.png
  13. Задать какой-нибудь текст УП на панели параметров <Рабочее задание > операции на основе текста УП, например:

    G0 G17 X0 Y0 Z0
    X100
    Y100
    X0
    Y0
  14. Выбрать созданный интерпретатор на панели параметров <Стратегия операции>:

    images/download/attachments/113361543/SelectInterpreter_En.png
  15. И нажать кнопку расчета операции images/download/thumbnails/113361543/RunButton_En.png

  16. Выполнение должно остановиться в заданной точке останова. Теперь вы можете использовать Шаг с обходом (F10) на панели инструментов, чтобы перемещаться по строкам кода интерпретатора.
    images/download/attachments/113361543/InterpreterDebugging_En.png

  17. Наконец, вы можете изменить код интерпретатора в файлах Interpreter.cs, Registers.cs и NewInterpreter.snci по мере необходимости и отладить его, используя все доступные функции кода Visual Studio Code. Если вы еще не знакомы с возможностями VS Code, рекомендуем вам посетить раздел его официальной документации «Начало работы» (https://code.visualstudio.com/docs/getstarted/introvideos).

  18. После того как вы написали и отладили исходный код интерпретатора, вы можете получить и использовать файлы динамически подключаемой библиотеки (*.dll) и настройки интерпретатора (*.snci). Просто выберите «Reveal in File Explorer» в контекстном меню соответствующих файлов (например, NewInterpreter.dll и NewInterpreter.snci в данном случае) проводника Visual Studio Code. При этом в проводнике будут выбраны указанные файлы интерпретатора, которые вы сможете скопировать и при необходимости отправить клиенту.images/download/attachments/113361543/VS_Code._%27Reveal_in_File_Explorer%27_En.png
    images/download/attachments/113361543/InterpreterFiles_En.png