rawdeal73 / flintium

Open-source library of Ignition® faceplates and graphics that pair with AOIs from the Rockwell Automation® Library of Process Objects.

Ignition Faceplates for Rockwell Process Library AOIs

Software

• Ignition v8.0.12
• PlantPAx_Process_Library_v4.10.01
• Studio 5000 v32.02
• Emulate v32.00

Quick Setup with Docker

See the Flintium Docker README for instructions to quickly setup everything needed to run Flintium.

Manual Setup

Option 1: Basic Setup

Follow these instructions to try the most recent Flintium release. Note: releases are infrequent, if you would like to use the latest Flintium code, see option 2.

• Download a Flintium Gateway backup from the Releases section of this repository. Click assets, then click on the .gwbk file.
• Restore the .gwbk following Ignition's gateway restore instructions.
• See the User Source, Usernames & Passwords for login details.
• Follow the instructions in the Database Setup, Modules Setup, and PLC Setup sections below to complete the setup.

Option 2: Development Setup

Follow these instructions if you would like to use the latest Flintium code, or help develop Flintium.

• On your Ignition Gateway computer, open your /Ignition/data/projects folder, and run
  git clone https://github.com/jlbcontrols/Flintium.git
• Follow instructions below to Import Gateway Resources.
• Follow the Database Setup, Modules Setup, and PLC Setup instructions below to complete the setup.

Additional Setup

Import Gateway Resources (Required for Development Only)

• Import UDTs into Ignition. Flintium's UDTs are stored as a folder structure to improve merging. They must be imported using the tool on project window: Flintium/Administration/ExportImportTags. See Flintium Wiki page Importing & Exporting UDTs for more info.
• Import the example instance tags using the Ignition Designer's built-in tool. The tags are saved as /gw-resources/tags/FlintiumInst.json, which should be imported into the default provider's root folder.
• Import tag group files located in the /gw-resources/tags/tag-groups folder using the Ignition Designer's built-in tool.
• Create an internal user source using the Ignition gateway webpage, called FlintiumUserSource.
• Import /gw-resources/user-sources/FlintiumUserSource/roles.json using the tool located on project window: Flintium/Administration/Utilities/ExportImportRolesAndUsers
• Import /gw-resources/user-sources/FlintiumUserSource/users.json using the tool located on proejct window: Flintium/Administration/Utilities/ExportImportRolesAndUsers

Database Setup

By default, historical tags in this project use a database connection called historydb.

• Create a database to use with Ignition's Historian. Ignition supports many popular databases.
• Create a connection to your database called historydb using the gateway webpage. historydb may already exist depending on your setup method. Change the configuration of this connection as necessary to connect with your database.

Modules Setup

Two third party modules are used in this project. The pidbot module is used for tuning P_PIDE controllers. The Flintium Tag Config Tools module is used for development only, and is not required when using the Flintium library. Converts UDTs created from PlantPAx AOI tag OPC drag/drop, making it closer to the format required for this project.

• Download Pidbot module from JLB Controls.
• Download Flintium Tag Config Tools module from the releases section of the Github repository.
• Install the .modl files following Ignition's module installation instructions.

PLC Setup

The examlpe tags in this project are mapped to Ignition's built-in OPC server Ignition OPC UA Server, and a device plc1.

• Create a Logix Driver device called plc1 using the gateway webpage. plc1 may already exist depending on your setup method.
• Edit connectivity settings for plc1 to connect with your Logix PLC or RSLogix Emulate. See more details on setting up RSLogix Emulate.
• Develop your PLC code using AOIs from Rockwell's Process Library v4.10.01. Search for "Process Library" in Rockwell Downloads.
• See Issue #162 for the status of the Studio 5000 project file associated with Flintium's example tags.

User Source, Usernames & Passwords

Gateway/Designer

• Login credentials for the Ignition Gateway webpage are username: admin, password password.
• Gateway uses the Default user source.
• If logging into the Designer with Default (or other) user source: To have full permissions for all example project faceplates in the designer, add these roles to your user: Administrator and area01.

Client

• The project's user source is FlintiumUserSource by default. Note: This means that users must belong to FlintiumUserSource to log into a client.
• Default users are configured in FlintiumUserSource: defaultAdmin, defaultEngr, defaultMaintSup, defaultMaint, defaultOperSup and defaultOper. The default password for all users is password.

More Information

For more information about this project, and how to contribute head to the Flintium Wiki.