CS-CS.Net: Лаборатория Электрошамана

Файлы проектов ПЛК для CodeSys 2.3 и CodeSys 3.5

У меня снова подъехали интересные технологии! Возможно, несколько постов до конца этого года будут только про CodeSys, а не про электрощиты. На этот раз я расскажу вам про удобные технологии переноса файлов проектов CodeSys 2.3 и 3.5 на другие компьютеры. Они сильно сэкономят вам время в следующих случаях:

• Когда вы меняете рабочий компьютер, и надо перенести на новый все таргеты и библиотеки со старого;
• Когда вы на чужом компьютере будете первый раз загружать свой проект для работы (например, если вы оказались в чистом поле без интернета только с архивом проекта и не можете даже на сайт ОВЕН попасть, чтобы скачать нужные библиотеки и таргеты);
• Когда вы передаёте исходные файлы вашего проекта заказчику (у вас, как и у меня, это должно быть прописано в Договоре).

Дело в том, что в CodeSys есть удобная штука: «Архив проекта», при создании которого в него добавляется сам проект и все связанные с ним файлы: таргеты, библиотеки и даже настройки самого CodeSys. А в старом CodeSys 2.3 есть команда «Загрузка исходных текстов», которая создаёт в ПЛК файл «Source.Dat». Я расскажу вам, как всем этим пользоваться и в том числе как загрузить проект из Source.Dat, если вам попался такой файл.

Здесь нам потребуются базовые знания о CodeSys: Как подключаться к ПЛК, Как просматривать список файлов в ПЛК, Как читать и записывать файлы в ПЛК. Часть из этих знаний про CodeSys 2.3 была рассказана в старом посте от 2016 года.

1. Структура и назначение файлов с папках с проектами CodeSys.

Первое, с чем я сталкивался, читая ОВЕНский форум — это случаи, в которых исходный файл проекта передают Заказчику, он пытается подключиться с ним к ПЛК, а CodeSys говорит о том, что исходный и загруженный проекты в ПЛК не совпадают и предлагает только заново полностью загрузить проект в ПЛК.

Связано это с тем, что проекты CodeSys компилируются. Это означает, что все исходные тексты проекта преобразуются в машинный код для ПЛК, и только потом загружаются в него. Результат компиляции проекта сохраняется в файл рядом с исходным проектом. По этому файлу среда разработки сравнивает проект в ПЛК с текущим. И, конечно же, если этот файл не найден, CodeSys не сможет сравнить проекты и предложить загрузить весь проект заново с полной остановкой ПЛК. При этом даже если создать такой файл отдельно, скомпилировав проект, он всё равно не подойдёт: нужен файл именно с того момента, когда проект был загружен в ПЛК.

В папке с проектом ПЛК создаются файлы с разными расширениями (я рекомендую тем, кто занимается разработкой, включать отображение расширений файлов в Windows). Давайте разберёмся с тем, какие для нас будут важны и что они означают.

1.1. Файлы CodeSys 2.3.

Список связанных файлов проекта CodeSys 2.3

• .Pro — Исходный файл проекта CodeSys 2.3. Дополнительно к нему могут требоваться разные библиотеки, которые могут храниться в других местах (общей папке или там, где вам нравится);
• .Bak — Резервная копия файла проекта.  Создаётся при каждом сохранении, если включена настройка в меню и окне настроек «Проект => Опции => Сохранение => Резервное копирование». Также я рекомендую установить галочки «Автосохранение» и «Автосохранение перед компиляцией».
  Этот файл проекта перезаписывается при КАЖДОМ сохранении проекта. Поэтому он НЕ поможет, если вам надо вернуться ко вчерашней версии проекта. Делайте отдельные резервные копии!
• .Stab (.Stable) — Это я сам руками сохранил стабильную версию проекта, переименовав файл;
• .Log — Журнал подключений к ПЛК, который выводится в разделе «Бортжурнал». В меню и окне настроек «Проект => Опции => Бортжурнал => Директория для файлов журнала» можно задать нужную папку их хранения. Тогда они не будут создаваться в папке с проектом, чтобы не мешаться (обычно они не нужны);
• .Ci, .Ri — Файлы информации компиляции и онлайн-обновления проекта. Вот их как раз и надо передавать вместе с проектом, чтобы подключаться к ПЛК без полной загрузки;
• .Sdb, .Sym — Файлы информации обо всех символах (переменных и объектах), которые используются в проекте, если настроена их выгрузка и создание. Они используются для передачи этой информации в OPC-серверы;
• DEFAULT.PRG, DEFAULT.CHK — файлы ЗАГРУЗОЧНОГО (исполняемого) проекта, которые должны быть загружены в ПЛК, чтобы при его включении наша программа начала сразу выполняться. В обычном варианте эти файлы должны находиться внутри ПЛК, а не на диске компьютера.
  Они формируются так: надо подключиться к ПЛК и выполнить команду «Онлайн => Создание загрузочного проекта».
  Если же выполнить эту команду без подключения к ПЛК, то эти файлы создадутся в папке проекта, но будут не нужны;
• Source.Dat — Исходные тексты проекта ПЛК вместе с его библиотеками. Мы поговорим про него дальше в этой статье. И снова, аналогично файлам загрузочного проекта, этот файл должен находиться в ПЛК, а не на диске компьютера.

1.2. Файлы CodeSys 3.5.

Список связанных файлов проекта CodeSys 3.5

• .Project — Исходный файл проекта CodeSys 3.5. Дополнительно к нему могут требоваться разные библиотеки, которые хранятся в репозитории CodeSys;
• .Backup — Резервная копия файла проекта.  Создаётся при каждом сохранении, если включена соответствующая настройка в Опциях проекта.
  Этот файл проекта перезаписывается при КАЖДОМ сохранении проекта. Поэтому он НЕ поможет, если вам надо вернуться ко вчерашней версии проекта. Делайте отдельные резервные копии!
• .Stable — Это я сам руками сохранил стабильную версию проекта, переименовав файл;
• .ProjectArchive — Файл Архива Проекта, про который я расскажу в этом посте дальше. Содержит исходный файл проекта, все нужные таргеты, библиотеки и настройки CodeSys;
• .BootInfo, .BootInfo_GUIDs, .CompileInfo — Файлы информации компиляции и онлайн-обновления проекта. Вот их как раз и надо передавать вместе с проектом, чтобы подключаться к ПЛК без полной загрузки;
• .XML — Файл символов для выгрузки в Облако ОВЕН или OPC-серверы (создаётся автоматически);
• .Opt — Состояние окон CodeSys и проекта. Здесь запоминаются все текущие открытые окна внутри проекта и их расположение;
• Archive.prj — Файл архива проекта, выгруженный из ПЛК. При выборе команды загрузки исходных текстов в ПЛК он создаётся на диске автоматически. Его содержимое зависит от выбранных компонентов для загрузки в ПЛК и может отличаться от файла .ProjectArchive.

2. Загрузка и чтение из ПЛК исходных текстов (Source.Dat, CodeSys 2.3).

В среде CodeSys 2.3 есть классная возможность — загрузить исходные файлы в ПЛК. При этом в ПЛК создаётся специальный файл Source.Dat, в котором хранится исходный код проекта, информация о его компиляции и все используемые библиотеки. Если вы (как нормальный интегратор) передаёте заказчикам исходные коды программ на ПЛК, то заодно загрузите их в ПЛК. Это поможет заказчику восстановить проект напрямую из ПЛК, если другие исходные файлы утеряны.

Работает загрузка исходных текстов просто. Вам надо подключиться к ПЛК и выполнить команду из меню «Онлайн => Загрузка исходных текстов»:

Загрузка исходных текстов в ПЛК CodeSys 2.3: Команда для загрузки

При этом CodeSys создаст файл Source.Dat и будет загружать его в ПЛК, показывая прогресс загрузки в таком окошке:

Загрузка исходных текстов в ПЛК CodeSys 2.3: Процесс загрузки

На этом процесс загрузки исходных текстов в ПЛК закончен.

Убедиться в том, что всё прошло успешно, можно через ПЛК-браузер, дав команду «filedir»:

Загрузка исходных текстов в ПЛК CodeSys 2.3: Файл Source.Dat находится в ПЛК

Файл Sources.Dat находится внутри ПЛК. Заодно мы видим, что в ПЛК есть загрузочный проект (файлы DEFAULT.PRG и DEFAULT.CHK). Дополнительно я выделил файл local_addres.dat, где хранятся настройки IP- и MAC-адреса ПЛК.

Как же загрузить проект из такого файла Source.Dat (я встречал такие вопросы в интернете и на форуме ОВЕНа)? Чтобы загрузить такой проект, нужно чтобы в ПЛК был этот самый Source.Dat. Я повторяю это для того, чтобы пояснить хитрость: если вам передали исходники в виде Source.Dat, то его НЕ надо пытаться распаковать как архив! Его надо загрузить внутрь ПЛК (подключиться к ПЛК и выполнить команду «Онлайн => Записать файл в ПЛК», указав нужный файл Source.Dat на компьютере), а потом уже загружать проект из ПЛК стандартным способом.

Итак, нам нужно выполнить стандартную команду «Файл => Открыть» (или нажать кнопку открытия проекта на панели инструментов):

Открытие исходных текстов Source.Dat из ПЛК CodeSys 2.3: Выбор команды открытия файла

Но в диалоге выбора файла указать не файл на диске, а выбрать команду «Открыть проект из ПЛК», нажав кнопку «ПЛК…» внизу диалога:

Открытие исходных текстов Source.Dat из ПЛК CodeSys 2.3: Выбор режима загрузки из ПЛК

CodeSys попросит вас указать таргет-файл (модель ПЛК), чтобы подключиться к нему для обмена файлами (то есть, нужный таргет-файл всё же надо скачать и установить на компьютере):

Открытие исходных текстов Source.Dat из ПЛК CodeSys 2.3: Выбор таргета текущего ПЛК

Далее CodeSys спрашивает нас о настройках подключения к ПЛК (нужно указать его IP-адрес):

Открытие исходных текстов Source.Dat из ПЛК CodeSys 2.3: Выбор параметров подключения к ПЛК

Если все настройки сделаны верно, то мы увидим окно прогресса загрузки данных из ПЛК (из этого самого Source.Dat):

Открытие исходных текстов Source.Dat из ПЛК CodeSys 2.3: Процесс загрузки проекта из ПЛК

Проект загружается и распаковывается в папку Upload, которая расположена там, где установлен CodeSys (C:\Program Files\CodeSys v2.3\CodeSys v2.3 у меня).

Есл вы когда-либо что-то загружали из ПЛК, и в этой папке остались файлы, то CodeSys спросит нас о том, можно ли их перезаписать (если нет — то процесс загрузки будет остановлен):

Открытие исходных текстов Source.Dat из ПЛК CodeSys 2.3: Вопрос о перезаписи настроек

В результате мы получаем исходный проект (который мы загружали) вместе со всеми его библиотеками:

Открытие исходных текстов Source.Dat из ПЛК CodeSys 2.3: Проект загрузился из ПЛК (Библиотеки тоже)

Вот такой вот удобный функционал есть в CodeSys 2.3.

3. Загрузка и чтение из ПЛК исходных текстов (Archive.Prj, CodeSys 3.5).

Функция загрузки исходных файлов в ПЛК есть и в CodeSys 3.5. Здесь она более продвинутая и по функционалу похожа на Архив Проекта, про который я расскажу ниже в этом посте. Так получилось, что из-за структуры поста удобнее написать про Исходные Тексты для обоих версий CodeSys, а потом про Архивы проектов для них же.

В этой версии CodeSys есть более продвинутые настройки режима создания и загрузки исходных текстов в ПЛК. Для того, чтобы их посмотреть, нужно (без подключения к ПЛК) выбрать команду «Проект => Установки проекта…»:

Загрузка исходных текстов в ПЛК CodeSys 3.5: Переход в настройки проекта

А в диалоге установок перейти в раздел «Загрузка исходного кода»:

Загрузка исходных текстов в ПЛК CodeSys 3.5: Настройка способа загрузки исходных текстов в ПЛК

Здесь есть несколько групп настроек:

• Можно выбрать устройства (ПЛК), в которые надо или не надо загружать исходники;
• Можно при помощи кнопки «Дополнительные файлы» выбрать библиотеки или другие компоненты, которые надо загружать;
• Можно выбрать то, в какой момент загружать исходники. Например, загружать исходники вместе с созданием загрузочного проекта автоматически (тогда вы никогда не забудете это сделать).

Загрузка исходных текстов в ПЛК CodeSys 3.5: Выбор компонентов для загрузки в ПЛК

В качестве дополнительных компонентов можно (и следует, несмотря на то, что я не указал) указать то, что надо загружать «Используемые библиотеки», «Используемые стили визуализации» и «Используемые устройства». В таком режиме в ПЛК загрузятся (а потом автоматически установятся в CodeSys) все нужные таргеты, библиотеки и стили визуализации. Если поставить все галочки, то размер архива может быть даже большее 100 мегабайт. Обычно в ПЛК достаточно свободного места для загрузки такого файла.

Это позволит настроить CodeSys на новом компьютере с нуля так, чтобы в нём корректно открылся текущий проект. Точно так же работает Архив Проекта в CodeSys 3.5, но мы поговорим про это это позднее.

После того, как все настройки сделаны, можно подключиться к ПЛК и дать команду «Онлайн => Загрузка исходных текстов на подсединённое устройство»:

Загрузка исходных текстов в ПЛК CodeSys 3.5: Команда онлайн-загрузки исходных текстов в ПЛК

В этом случае исходники будут загружены в подключенный ПЛК. Если в проекте есть несколько ПЛК, то они будут загружены только в тот, к которому мы подключены.

CodeSys сначала создаст файл архива Archive.Prj на диске (в папке, где расположен проект), а потом будет загружать его в ПЛК.

Загрузка исходных текстов в ПЛК CodeSys 3.5: Процесс загрузки исходных текстов в ПЛК

Другой вариант загрузки исходников — это подать команду «Файл => Загрузка исходного кода…»:

Загрузка исходных текстов в ПЛК CodeSys 3.5: Команда загрузки исходных текстов в ПЛК из меню Файл

Здесь у CodeSys УЖАСНО сделан перевод: есть команда «Выгрузка», а есть «Загрузка». Нам нужна именно «Загрузка» (исходников В ПЛК).

Нам предложат выбрать ПЛК, в который нужно загрузить исходники (CodeSys будет пытаться подключиться к нему):

Загрузка исходных текстов в ПЛК CodeSys 3.5: Диалог выбора ПЛК для загрузки исходных текстов

А после этого пойдёт процесс загрузки:

Загрузка исходных текстов в ПЛК CodeSys 3.5: Процесс загрузки исходных текстов в ПЛК через меню Файл

После успешной загрузки мы можем зайти в просмотр файловой системы ПЛК и увидеть то, что у нас создался файл Archive.Prj:

Загрузка исходных текстов в ПЛК CodeSys 3.5: Файл Archive.Prj загружен в ПЛК

Что из себя представляет этот архив исходников Archive.Prj в CodeSys 3.5? Да это обычный ZIP-архив, в котором во внутреннем формате CodeSys находится исходный файл проекта, а во вложенных папках — различные таргеты ии библиотеки, если их загрузка была включена галочками в Дополнительных файлах в настройках проекта:

Загрузка исходных текстов в ПЛК CodeSys 3.5: Содержимое файла Archive.Prj с дополнительными компонентами (библиотеки)

Распаковывать этот архив не надо: CodeSys 3.5 выгодно отличается и сделает это за вас сам.

Как загрузить проект из ПЛК в CodeSys 3.5 (если нужно — вы можете загрузить в ПЛК другой файл Archive.Prj и прочитать его этим же способом)?

Идём в меню «Файл» и выполняем команду «Файл => Выгрузка исходного кода…»:

Открытие исходных текстов Archive.Prj из ПЛК CodeSys 3.5: Команда из меню Файл для загрузки

Создавать новый пустой проект при этом не обязательно, но для того, чтобы эта команда сработала, в CodeSys должен быть установлен таргет-файл нужного нам ПЛК.

После этого нас снова попросят выбрать тот ПЛК, к которому надо будет подключиться (я не стал показывать второй раз это же окно), а потом пойдёт процесс чтения файла архива из ПЛК:

Открытие исходных текстов Archive.Prj из ПЛК CodeSys 3.5: Процесс скачивания из ПЛК файла Archive.Prj

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

Если бы я отметил галочками различные библиотеки или таргеты, то они появились бы в этом списке:

Открытие исходных текстов Archive.Prj из ПЛК CodeSys 3.5: Выбор компонентов для распаковки и установки в систему

Ну а дальше нас спрашивают о том, хотим ли мы открыть свежезагруженный проект в среде разработки:

Открытие исходных текстов Archive.Prj из ПЛК CodeSys 3.5: Диалог вопроса об открытии распакованного проекта

И, если мы соглашаемся, начинается загрузка проекта:

Открытие исходных текстов Archive.Prj из ПЛК CodeSys 3.5: Процесс загрузки распакованного проекта в ПЛК

4. Создание и загрузка Архива проекта ПЛК (CodeSys 2.3).

Архив Проекта — это мощная функция в CodeSys, и по большей части я выбрал CodeSys как среду разработки из-за неё, потому что при помощи Архива Проекта можно в ОДИН файл запаковать и сохранить ВСЁ, что требуется для открытия проекта на новом компьютере с установленным CodeSys без таргетов и библиотек!

Чтобы создать Архив Проекта, нужно открыть проект в ПЛК и выбрать команду «Файл => Сохранить/Отправить архив…»:

Создание Архива проекта в CodeSys 2.3: Выбор команды

После этого откроется диалоговое окно, где можно (и НУЖНО) установить галочки на тех элементах, которые будут включены в архив (можно ставить ВСЕ, хуже не будет):

Создание Архива проекта в CodeSys 2.3: Список того, что войдёт в Архив

Особое внимание следует обратить на галочку «Файлы целевой платформы». По умолчанию она отмечена серым, и это означает то, что в Архив Проекта будут добавлены таргеты только для текущего ПЛК.

Если эту галочку установить, то в Архив Проекта добавятся ВСЕ установленные на компьютере таргеты (это удобно, если надо «переехать» на другой компьютер для полноценной работы в CodeSys):

Создание Архива проекта в CodeSys 2.3: Список используемых таргетов (выбраны все)

Если нажать кнопку «Детали» напротив галочек, то можно посмотреть на то, какие именно файлы будут включены в Архив Проекта и убрать ненужные.

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

Создание Архива проекта в CodeSys 2.3: Список используемых библиотек

Если нужно добавить в Архив что-то ещё, то можно нажать кнопку «Иные файлы» и добавить их в отдельном окне:

Создание Архива проекта в CodeSys 2.3: Список дополнительных файлов, если надо

При помощи кнопки «Комментарий» можно добавить комментарий. Он будет записан в файле «Readme.txt» Архива:

Создание Архива проекта в CodeSys 2.3: Добавление комментария архива

После того, как все настройки Архива будут сделаны, нужно нажать на кнопку «Сохранить…» и указать файл, в который Архив Проекта будет сохраняться.

Далее запустится процесс добавления файлов в Архив, а окне сообщений будет видно то, какие файлы добавляются:

Создание Архива проекта в CodeSys 2.3: Процесс создания архива

Не пугайтесь ошибок: они появляются тогда, когда вы отметили для добавления в архив те файлы, которые не созданы средой. Например, если установить галочку «Загрузочный проект», то CodeSys будет искать файлы .PRG и .CHK с именем проекта, которых может не быть. Архив будет создан без них — и это для него нормально.

Что делать с этим Архивом? В CodeSys 3.5 (про него будет сказано в следующем разделе) сам CodeSys может правильно загрузить Архив. А вот в среде CodeSys 2.3, про которую я рассказываю сейчас, Архив Проекта — это обычный ZIP-архив, в котором все файлы сохранены с полными исходными путями:

Создание Архива проекта в CodeSys 2.3: Готовый архив (содержимое)

На другом компьютере нужно установить CodeSys в ту же папку, как и на старом (расположение будет видно по пути библиотек и таргетов), а потом распаковать файлы из архива в те папки, где они находились.

В моём случае я установил все таргеты в папку Targets CodeSys, и поэтому на другом компьютере они должны находиться там же.

Наш комментарий к Архиву записан в файле «Readme.TXT»:

Создание Архива проекта в CodeSys 2.3: Готовый архив (просмотр комментария)

В корне архива находится важный файл «Registry.reg». В нём хранятся настройки CodeSys и привязки таргетов к папкам на диске. Этот файл нужно внести в реестр двойным щелчком мыши.

Создание Архива проекта в CodeSys 2.3: Готовый архив (просмотр настроек и таргетов в реестре)

Если всё будет сделано правильно, то на «новом» компьютере вы получите CodeSys 2.3 с теми же настройками, таргетами и библиотеками, как и на «старом».

5. Создание и загрузка Архива проекта ПЛК (CodeSys 3.5).

Смысл Архива Проекта в CodeSys 3.5 — точно такой же, как и в CodeSys 2.3: перенести между компьютерами все исходники, все таргеты, библиотеки и настройки среды разработки. А так как все таргеты и библиотеки в CodeSys 3.5 хранятся в репозитории, то распаковка Архива Проекта в CodeSys 3.5 автоматически корректно установит их туда, куда следует (и не надо будет руками распаковывать ZIP-архив и копировать из него файлы, как это было в CodeSys 2.3).

Создание Архива Проекта работает аналогично CodeSys 2.3. Нужно открыть необходимый проект и выполнить команду «Файл => Архив проекта => Сохранить/отправить архив…»:

Создание Архива проекта в CodeSys 3.5: Выбор команды

После этого откроется диалоговое окно с выбором элементов, которые нужно включить в архив проекта:

Создание Архива проекта в CodeSys 3.5: Список того, что войдёт в Архив

Здесь есть выбор среди библиотек, стилей визуализации, устройств, настроек самого CodeSys, профилей библиотек и визуализации под текущий проект и файлы компиляции и загрузки (чтобы подключаться к ПЛК без загрузки проекта, о чём я говорил в первом разделе поста).

Точно так же можно добавить файлы (и ещё и папки) в Архив Проекта:

Создание Архива проекта в CodeSys 3.5: Список дополнительных файлов, если надо

И комментарий — тоже:

Создание Архива проекта в CodeSys 3.5: Добавление комментария архива

После нажатия кнопки «Сохранить…» будет отображаться прогресс создания Архива. Например, здесь видно то, что в Архив добавляется одна из библиотек ОВЕН, чтобы потом быть корректно установленной на другом компьютере.

Создание Архива проекта в CodeSys 3.5: Процесс создания архива

После окончания архивации мы получим файл с расширением .ProjectArchive размером около 100 (и выше) мегабайт. Не следует отсылать такие большие файлы по электронной почте. Выгрузите его на FTP или облачный сервер или передайте заказчику на флешке.

Как распаковать такой архив? Можно воспользоваться командой меню «Файл => Архив проекта => Распаковать архив…» или поступить проще: сделать двойной щелчок мышкой на файле .ProjectArchive.

Запустится менеджер компонентов, и после этого появится диалог распаковки Архива:

Создание Архива проекта в CodeSys 3.5: Окно распаковки архива проекта

Здесь нужно отметить галочками необходимые элементы для загрузки (например, если отметить «Опции», то все настройки CodeSys будут такие же, как на компьютере, где был сохранён Архив) и нажать кнопку «Распаковать».

При распаковке Архива все таргеты, профили визуализации, библиотеки будут установлены в репозиторий CodeSys, а исходный файл проекта .Project будет распакован в текущую папку. То есть, после распаковки такого Архива вы получите исходный файл проекта и среду CodeSys со всеми установленными элементами, которые были на исходном компьютере.

Проекту исполнилось 15 лет! Поддержать проект материально, проспонсировать проекты Автора или сделать ему подарок можно на этой странице: "Донаты и Спонсорство, Список Желаний".