Use the Siemens S7 Browse Agent

with the siemens s7 browse agent, you can export tags and variables from a tia portal project and import them into litmus edge the agent will export all input (i), output (q), and memory (m) tags from the tag table and tags from all non optimized data blocks see tag data type conversions docid\ dl sxmh59rmxfzthcut3o to learn more before you begin create a tia portal project that includes the s7 plc that you want to add to devicehub the project should have only one plc if you have more than one plc in your project, create copies of your project with only plc in each project and run the agent separately for each project go to the litmus central portal and download the corresponding agent for your version of tia portal if the tia portal project is open, close the project follow the steps below to enable tia openness enable tia openness type lusrmgr msc in the start menu and press enter the local user management console opens click groups then, right click siemens tia openness and select add to group the siemens tia openness properties window opens on the siemens tia openness properties window, click add the select users window opens on the select users window, click advanced another window titled select users opens click find now in the new window the search results populate find your windows user, select it, then click ok the new select users window closes, and the original select users window now shows your user name click ok the original select users window closes on the siemens tia openness properties window, click apply close the remaining windows, log out of windows, and then log back in use the siemens s7 browse agent using the siemens s7 browse agent includes the following tasks step 1 add siemens s7 device to devicehub step 2 extract the siemens s7 browse agent step 3 copy the library file step 4 create an api key step 5 configure the siemens s7 browse agent step 6 export tags to csv file step 7 upload tags to litmus edge step 1 add siemens s7 device to devicehub in litmus edge, navigate to devicehub > devices click the connect a device box the connect device dialog box appears in the device type drop down list, select siemens in the driver name drop down list, select siemens s7 or siemens s7 advanced (gen1) configure the parameters for the device see connect a device docid\ ish7bqhzxswtdx8vbnszb and siemens s7 docid\ lhipmt2rl9hnntmv mjp5 or siemens s7 advanced (gen1) docid\ mg oskprv0lvqduytsf8a to learn more copy the name you gave to the device and paste it somewhere for reference later step 2 extract the siemens s7 browse agent in windows explorer, extract the contents of the downloaded zip file open the extracted folders until you view the files exportcsv 16 exe and litmus siemens dll step 3 copy the library file locate the file siemens engineering dll in your program installation folder if you have tia portal v15, it is located in program files > siemens > automation > portal v15 > public api > v15 if you have tia portal v15 1, it is located in program files > siemens > automation > portal v15 1 > public api > v15 1 if you have tia portal v16, it is located in program files > siemens > automation > portal v16 > public api > v16 copy siemens engineering dll paste the file into the siemens s7 browse agent folder, next to the exe file and litmus siemens dll step 4 create an api key this is an optional step which allows the siemens s7 browse agent to upload the tag csv file to litmus edge to create an ap key navigate to system > tokens in the rest api keys section, click the add rest api key icon enter a name for the token in the key name field, and then click create api key in the value column for the key, click the copy icon and paste it somewhere for reference later step 5 configure the siemens s7 browse agent from the v16 folder, double click the exportcsv 16 exe file to open the agent the devicehub automated tag generation dialog box appears click the project diff file browse icon and navigate to your tia portal project the default save file path is documents > automation > project name > project name ap16 , where project name is the name you gave your project select the project file and click open click the csv file browse icon, navigate to the folder you want to store the csv file, enter v15 tags in the file name field, and then click save configure the following parameters devicehub driver during "step 1 add siemens s7 device to devicehub," if you added a device using the siemens s7 advanced (gen1) driver, select gen1 if you used the siemens s7 driver, select gen2 device name paste the device name that you copied in "step 1 add siemens s7 device to devicehub " gateway address (optional) enter the litmus edge ip address api token (optional) paste the rest api key that you copied in "step 4 create an api key " step 6 export tags to csv file from the siemens s7 browse agent dialog box, click export view the logs pane to see the export process when the openness access popup window appears, select yes or yes to all to grant access to the agent this process may take some time when you see finished in the logs pane, the tags are exported to a csv file navigate to the folder on your hard drive that you designated for the csv file and confirm it was successfully created step 7 upload tags to litmus edge if you skipped "step 4 create an api key," you will need to upload the tag csv file from litmus edge devicehub instead of from the siemens s7 browse agent see add tags docid\ xgwokqbtpevii7or82ll0 to learn more from the siemens s7 browse agent dialog box, click upload in litmus edge, navigate to devicehub > tags click the siemens s7 device confirm the tags from the csv file are successfully uploaded