PLCnext CLI テンプレート

新しい PLCnext CLI プロジェクト テンプレートのディレクトリを作成します。

Linux の場合:

user@machine:~/plcncli/Templates$ mkdir ExeTemplate && cd ExeTemplate

テンプレート C++ コードを含むファイルを作成します。このファイルは、このタイプのすべての新しいプロジェクトの開始点として使用できます。

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

この例で使用されている C++ コードは次のとおりです。

#include 

int main() {
   std::cout << "Hello World!" << std::endl;
   return 0;
}   

テンプレート 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
    $)

#######################################################################################

################# 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 に渡されるプロジェクトの名前に置き換えられます。 コマンド。

オプション:README ファイルを新しいテンプレート ディレクトリに追加します。これは、このテンプレートから作成された新しいプロジェクトごとに README ファイルを作成するためにも使用できます。

PLCnext CLI プロジェクト構成ファイルを作成します。

このファイルは、PLCnext CLI のプロジェクト構成情報を保存するために使用されます。プロジェクトをビルドするターゲットのリスト。

この例では、.proj ファイルは ConsumableLibraryTemplate からコピーされました ディレクトリを編集して、以下を生成します:

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

Type フィールドには、このプロジェクト テンプレートの一意の名前が含まれている必要があります。これは、次のステップでテンプレート記述ファイルにも含まれます。

Name フィールドにはプレースホルダー $(name) が含まれます これは、新しいプロジェクトを作成するたびにプロジェクト名に置き換えられます。

テンプレート記述ファイルを作成します。

この例では、TemplateDescription.xml ファイルは ConsumableLibraryTemplate からコピーされました ディレクトリを編集して、以下を生成します:

<?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="http://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 の関連セクションに表示されるフィールド ヘルプ システム。

新しいテンプレート ファイルを作成します。これは、新しいテンプレートについて PLCnext CLI に伝えるために使用されます。

この例では、MinimalAcfTemplates.xml Templates のファイル ディレクトリは CustomTemplates.xml という名前のファイルにコピーされました であり、そのファイルは次のように編集されました:

<?xml version="1.0" encoding="utf-8"?>
<Templates xmlns="http://www.phoenixcontact.com/schema/clitemplates">
         <Include type="Template">ExeTemplate/TemplateDescription.xml</Include>
</Templates>

カスタム テンプレートを PLCnext CLI に登録します

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

パスは、PLCnext CLI インストール ディレクトリに対する相対パスです。

試してみてください!

次の bash コマンドのリストは、新しいテンプレートの機能を示しています:

plcncli new                                   # The help text includes the new template and description
plcncli new exeproject --help                 # Displays the example showing how to use this template
plcncli new exeproject --name "HelloWorld"    # Creates a new project based on the template
cd HelloWorld
plcncli set target -n AXCF2152 -v 2022 --add  # Sets the build target
plcncli build                                 # Builds the project with the default template code
scp bin/AXCF2152_22.0.3.129/Release/HelloWorld [email protected]:~  # Copies the executable to the device
ssh [email protected]
./HelloWorld                                  # Runs the executable!