산업 제조
산업용 사물 인터넷 | 산업자재 | 장비 유지 보수 및 수리 | 산업 프로그래밍 |
home  MfgRobots >> 산업 제조 >  >> Manufacturing Technology >> 산업기술

PLCnext CLI 템플릿: C++ 개발 효율화하기

이 문서는 PLCnext CLI 버전 22.0.0 LTS에 적용됩니다.


PLCnext Control 장치를 C++로 프로그래밍한다면, PLCnext CLI와 함께 설치되는 코드 템플릿을 사용해 보셨을 겁니다.

Visual Studio와 Eclipse에서는 PLCnext 프로젝트 마법사(PLCnext IDE 확장으로 설치됨)로 새 프로젝트를 만들 때 사용할 프로젝트 템플릿을 선택해야 합니다.

PLCnext CLI로 명령줄에서 새 C++ 프로젝트를 생성할 때도 프로젝트 템플릿을 지정해야 합니다.

기본 프로젝트 템플릿 세 가지는 다음과 같습니다:

project     사용자 프로그램용 템플릿. PLM(Program Library Manager)이 관리합니다.
acfproject  컴포넌트 기반 플랫폼 개발용 템플릿. 결과 컴포넌트는 ACF(Application Component Framework)가 관리합니다.
consumablelibrary  다른 프로젝트에서 사용할 수 있는 라이브러리를 생성하는 템플릿입니다.

위 정보는 plcncli new 명령어를 실행하면 확인할 수 있습니다. 이러한 프로젝트 유형에 대한 자세한 내용은 PLCnext Info Center에서 확인하세요:

이 문서에서는 PLCnext CLI와 함께 설치되는 추가 프로젝트 템플릿을 활성화하고 사용하는 방법, 그리고 나만의 프로젝트 템플릿을 만들고 사용하는 방법을 설명합니다.

먼저 PLCnext CLI 템플릿 시스템이 어떻게 작동하는지 살펴보겠습니다.

PLCnext CLI 템플릿 시스템

PLCnext CLI에는 TemplateLocations라는 기본 설정이 포함되어 있어 코드 템플릿을 찾을 위치를 알려줍니다. 다음 명령어로 이 설정 값을 확인할 수 있습니다:

user@machine:~$ plcncli get setting TemplateLocations
{
  "setting": {
    "TemplateLocations": "./Templates/Templates.xml"
  }
}

XML 파일의 경로는 plcncli 설치 경로를 기준으로 한 상대 경로입니다.

./Templates 디렉토리를 탐색하면 Templates.xml 파일과 여러 하위 디렉토리를 볼 수 있습니다.

Templates.xml 파일의 내용을 나열해 보면...

user@machine:~/plcncli/Templates$ cat Templates.xml
<?xml version="1.0" encoding="utf-8"?>
<Templates xmlns="https://www.phoenixcontact.com/schema/clitemplates">
  <Include type="Template">ProjectTemplate/TemplateDescription.xml</Include>
  <Include type="Template">ProgramTemplate/TemplateDescription.xml</Include>
  <Include type="Format">ProjectTemplate/FormatTemplates.xml</Include>
  <Include type="Template">ComponentTemplate/TemplateDescription.xml</Include>
  <Include type="Template">BaseTemplates/BaseTemplateDescription.xml</Include>
  <Include type="Template">BaseTemplates/CodeTemplateDescription.xml</Include>
  <Include type="Fields">BaseTemplates/FieldTemplates.xml</Include>
  <Include type="Types">BaseTemplates/TypeTemplates.xml</Include>
  <Include type="Format">BaseTemplates/FormatTemplates.xml</Include>
  <Include type="Template">AcfProjectTemplate/TemplateDescription.xml</Include>
  <Include type="Template">BaseProjectTemplate/TemplateDescription.xml</Include>
  <Include type="Template">AcfComponentTemplate/TemplateDescription.xml</Include>
  <Include type="Template">BaseComponentTemplate/TemplateDescription.xml</Include>
  <Include type="Template">ConsumableLibraryTemplate/TemplateDescription.xml</Include>
</Templates>

... Templates 디렉토리 아래의 다양한 유형의 TemplateDescription.xml 파일에 대한 참조를 볼 수 있습니다. 이 파일들은 해당 템플릿이 사용될 때 PLCnext CLI가 수행할 작업에 대한 지침을 포함합니다.

위에 표시된 템플릿 설명 파일들은 이미 익숙한 세 가지 기본 프로젝트 템플릿을 구현합니다.

추가 템플릿 활성화 방법

PLCnext CLI와 함께 기본적으로 설치되지만 기본적으로는 사용할 수 없는 '숨겨진' 프로젝트 템플릿이 하나 있습니다:

minimumproject  acfproject와 동일하지만, 전역 데이터 공간에서 포트 변수 생성 기능이 없습니다.

Templates 디렉토리에 이미 있는 MinimalAcfTemplates.xml 파일을 템플릿 위치 설정에 추가하여 이 템플릿을 PLCnext CLI에서 사용할 수 있게 할 수 있습니다:

user@machine:~$ plcncli set setting TemplateLocations ./Templates/MinimalAcfTemplates.xml --add

이제 새 XML 파일이 템플릿 위치에 추가되었습니다:

user@machine:~$ plcncli get setting TemplateLocations
{
  "setting": {
    "TemplateLocations": "./Templates/Templates.xml;./Templates/MinimalAcfTemplates.xml"
  }
}

... plcncli new 명령어를 실행하면 옵션 목록에 minimumproject가 나타납니다. 이제 이 템플릿을 사용하여 명령줄에서 새 C++ 프로젝트를 생성할 수 있습니다.

참고: PLCnext CLI에 프로젝트 템플릿을 추가해도 Visual Studio나 Eclipse 프로젝트 마법사에 자동으로 추가되지는 않습니다.

나만의 PLCnext CLI 템플릿 만들기

간단한 예제를 통해 커스텀 PLCnext CLI 템플릿 생성을 시연하겠습니다. C++로 'Hello World!' 콘솔 애플리케이션을 생성하는 PLCnext CLI 템플릿을 만들어 보겠습니다.

절차는 다음과 같습니다:

  1. 새 PLCnext CLI 프로젝트 템플릿용 디렉토리를 생성합니다.

    Linux에서:

    user@machine:~/plcncli/Templates$ mkdir ExeTemplate && cd ExeTemplate
    
  2. 모든 새 프로젝트의 시작점으로 사용할 템플릿 C++ 코드 파일을 생성합니다.

    user@machine:~/plcncli/Templates/ExeTemplate$ touch Main.cpp
    

    이 예제에서 사용된 C++ 코드는 다음과 같습니다:

    #include <iostream>
    int main() {
      std::cout << "Hello World!" << std::endl;
      return 0;
    }
    
  3. 템플릿 CMake 소스 파일을 생성합니다.

    user@machine:~/plcncli/Templates/ExeTemplate$ touch CMakeLists.txt
    

    이 예제에서 사용된 CMake 코드는 다음과 같습니다:

    cmake_minimum_required(VERSION 3.13)
    project($(name))
    if(NOT CMAKE_BUILD_TYPE)
      set(CMAKE_BUILD_TYPE Release)
    endif()
    ################# create target #######################################################
    file(GLOB_RECURSE Headers CONFIGURE_DEPENDS src/*.h src/*.hpp src/*.hxx)
    file(GLOB_RECURSE Sources CONFIGURE_DEPENDS src/*.cpp)
    add_executable(${CMAKE_PROJECT_NAME} ${Headers} ${Sources})
    #######################################################################################
    ################# set install directories #############################################
    string(REGEX REPLACE "^.*\(([0-9]+\.[0-9]+\.[0-9]+\.[0-9]+).*$" "\1" _ARP_SHORT_DEVICE_VERSION ${ARP_DEVICE_VERSION})
    set(BIN_INSTALL_DIR ${ARP_DEVICE}_${_ARP_SHORT_DEVICE_VERSION}/${CMAKE_BUILD_TYPE})
    #######################################################################################
    ################# project include-paths ###############################################
    target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src>)
    #######################################################################################
    ################# include arp cmake module path #######################################
    list(INSERT CMAKE_MODULE_PATH 0 "${ARP_TOOLCHAIN_CMAKE_MODULE_PATH}")
    #######################################################################################
    ################# set link options ####################################################
    # WARNING: Without --no-undefined the linker will not check, whether all necessary
    # libraries are linked. When a library which is necessary is not linked,
    # the firmware will crash and there will be NO indication why it crashed.
    #######################################################################################
    target_link_options(${CMAKE_PROJECT_NAME} PRIVATE LINKER:--no-undefined)
    #######################################################################################
    ################# add link targets ####################################################
    find_package(ArpDevice REQUIRED)
    find_package(ArpProgramming REQUIRED)
    target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE ArpDevice ArpProgramming)
    #######################################################################################
    ################# install #############################################################
    install(TARGETS ${CMAKE_PROJECT_NAME} RUNTIME DESTINATION ${BIN_INSTALL_DIR})
    unset(_ARP_SHORT_DEVICE_VERSION)
    #######################################################################################
    

    CMake 코드에는 $(name) 플레이스홀더가 포함되어 있으며, 이는 plcncli new 명령어에 전달된 프로젝트 이름으로 대체됩니다.

  4. 선택 사항: 새 템플릿 디렉토리에 README 파일을 추가합니다. 이 파일은 이 템플릿으로 생성된 각 새 프로젝트에도 README 파일을 만드는 데 사용될 수 있습니다.

  5. PLCnext CLI 프로젝트 구성 파일을 생성합니다.

    이 파일은 PLCnext CLI용 프로젝트 구성 정보(예: 프로젝트가 빌드되어야 할 타겟 목록)를 저장하는 데 사용됩니다.

    이 예제에서는 ConsumableLibraryTemplate 디렉토리의 .proj 파일을 복사하고 편집하여 다음을 만들었습니다:

    <?xml version="1.0" encoding="utf-8"?>
    <ProjectSettings xmlns="https://www.phoenixcontact.com/schema/cliproject">
      <Type>exeproject</Type>
      <Version>0.1</Version>
      <Name>$(name)</Name>
    </ProjectSettings>
    

    Type 필드에는 이 프로젝트 템플릿의 고유 이름이 포함되어야 하며, 다음 단계의 템플릿 설명 파일에도 포함됩니다.

    Name 필드에는 $(name) 플레이스홀더가 포함되어 있으며, 각 새 프로젝트 생성 시 프로젝트 이름으로 대체됩니다.

  6. 템플릿 설명 파일을 생성합니다.

    이 예제에서는 ConsumableLibraryTemplate 디렉토리의 TemplateDescription.xml 파일을 복사하고 편집하여 다음을 만들었습니다:

    <?xml version="1.0" encoding="utf-8"?>
    <TemplateDescription name="exeproject" isRoot="true" basedOn="baseproject" supportedFirmwareVersions="19.0.0.16199" requiredCliVersion="19.0.0.660" version="1.0" xmlns="https://www.phoenixcontact.com/schema/clitemplates" identifier="ProjectSettingsIdentifier">
      <File name="plcnext.proj" template=".proj"/>
      <File name="CMakeLists.txt" template="CMakeLists.txt"/>
      <File name="README.md" template="README.md"/>
      <File name="$(name)Main.cpp" template="Main.cpp" path="src"/>
      <Description>Create a new stand-alone executable project.</Description>
      <Example>
        <Arguments>
          <Argument name="name" value="MyExe"/>
        </Arguments>
        <Description>creates a new stand-alone executable project in the directory 'MyExe'</Description>
      </Example>
    </TemplateDescription>
    

    템플릿 설명의 필드는 다음과 같습니다:

    • name="exeproject": plcncli new exeproject 명령어로 이 템플릿에서 프로젝트를 생성할 수 있게 합니다.
    • File name="A" template="B" path="C": 지정된 템플릿 파일을 기반으로 지정된 경로에 새 프로젝트에 파일을 생성합니다. 파일 이름에는 $(name) 같은 플레이스홀더가 포함될 수 있으며, 각 새 프로젝트 생성 시 프로젝트 이름으로 대체됩니다.
    • Description 및 Example 필드: plcncli 도움말 시스템의 관련 섹션에 표시됩니다.
  7. PLCnext CLI에 우리 새 템플릿을 알리는 새 Templates 파일을 생성합니다.

    이 예제에서는 Templates 디렉토리의 MinimalAcfTemplates.xml 파일을 복사하여 CustomTemplates.xml이라는 파일로 만들고, 이를 편집하여 다음을 생성했습니다:

    <?xml version="1.0" encoding="utf-8"?>
    <Templates xmlns="https://www.phoenixcontact.com/schema/clitemplates">
      <Include type="Template">ExeTemplate/TemplateDescription.xml</Include>
    </Templates>
    
  8. 커스텀 템플릿을 PLCnext CLI에 등록합니다.

    user@machine:~$ plcncli set setting TemplateLocations ./Templates/CustomTemplates.xml --add
    

    경로는 PLCnext CLI 설치 디렉토리를 기준으로 한 상대 경로입니다.

  9. 테스트해 보세요!

    다음 bash 명령어 시퀀스는 새 템플릿의 기능을 보여줍니다:

    plcncli new                          # 도움말 텍스트에 새 템플릿과 설명 포함
    plcncli new exeproject --help        # 이 템플릿 사용 예시 표시
    plcncli new exeproject --name "HelloWorld"  # 템플릿 기반 새 프로젝트 생성
    cd HelloWorld
    plcncli set target -n AXCF2152 -v 2022 --add  # 빌드 타겟 설정
    plcncli build                        # 기본 템플릿 코드로 프로젝트 빌드
    scp bin/AXCF2152_22.0.3.129/Release/HelloWorld admin@192.168.1.10:~  # 실행 파일을 장치로 복사
    ssh admin@192.168.1.10 ./HelloWorld  # 실행 파일 실행!
    

기여하기

향후 GitHub의 PLCnext CLI Templates 프로젝트에 기여할 수 있도록 할 예정입니다. 그때까지는 새로운 템플릿 아이디어나 직접 만든 템플릿 예시를 이슈로 제출할 수 있습니다.

질문이나 의견?

아래에 댓글을 달거나 PLCnext Community Forum에서 질문하세요.

산업기술

  1. C++ 클래스 템플릿 마스터: 실전 가이드
  2. C++ 템플릿 마스터하기: 제네릭 프로그래밍 가이드
  3. 파이썬 XML 처리: 상호 운용 가능한 데이터 관리 가이드
  4. PLCnext Control에서 리눅스 터미널 명령어로 VLAN 설정 간소화하기
  5. PLCnext 디바이스에서 grpcurl로 안전한 원격 gRPC 접근 구현
  6. 알리바바 클라우드 커넥터를 PLCnext와 통합하기: 단계별 가이드
  7. DHCP로 IP 할당된 PLCnext 웹 서버에 안전하게 액세스하기
  8. PLCnext로 Wake-on-LAN을 통해 원격 PC 깨우기
  9. PLCnext에서 클러스터 관리: Kubernetes로 산업 자동화 활용하기
  10. Tableau 대시보드로 PLCnext 실시간 모니터링하기