Turbocraft Subroutines Readme ===================================================================== README: Turbocraft, Inc. Subroutines V1.1 June 6, 2002 ===================================================================== Maximize the Notepad window to read this file more easily. Contents: ========= 0. Introduction/Release notes I. Subroutines INSTALLATION II. Conventions III. License issues IV. Disclaimer V. Trademarks ===================================================================== 0. Introduction/Release notes ----------------------------------------- Turbocraft, Inc. has created a time-saving array of products for users of Opto 22's FactoryFloor® suite of software. This collection of subroutines is intended to be used in your OptoControl strategies, thus saving you the time of having to write them from scratch yourself. The subroutines are written without making use of any external commands in order to improve compatibility with future releases. Most of these subroutines have two versions; The nominal version is a "debug" version complete with comments, some error handling, completion status, and an elapsed timer that lets you know how long it took to complete - the other version is a stripped down "turbo" version (ending in "_T") that has had most of the comments, and the error handling and timer removed for speed. Use the nominal version first to debug your strategy, then when you are sure it is working correctly, switch to the "turbo" ("_T") version to improve the speed of execution. The subroutine timer will return the elapsed time required to complete the subroutine in a variable lableled "ET". This elapsed time is influenced by the speed of the processor and the number of tasks running concurrently with the chart that called the subroutine. Release Notes: Version 1.1 -Added new subroutines: Append_char_to_string_table_element, Append_string_to_string_table_element, Append_string_table_element_to_string, Append_substring_to_string Ramp_float Ramp_float_table_element Within_limits_float_table_elements -Revised numeric table math subroutines to allow source table and result table to be different: Add_to_float_table_element Add_to_int_table_element_32 Divide_float_table_element Divide_int_table_element_32 Multiply_float_table_element Multiply_int_table_element_32 Square_root_float_table Square_root_float_table_element Subtract_from_float_table_element Subtract_from_int_table_element_32 -Revised instruction manuals Version 1.0 First release I. Subroutines Installation ----------------------------------------- Requires 5.02 MB of hard drive space. 1) Use a zip utility to unzip Subroutines_1_1.zip 2) Double click the setup application Subroutines_1_1.exe 3) Read and either accept or reject the license agreement. Installing the software means you accept the license agreement in full and will abide by it. If you disagree with the license agreement then you are not allowed to install and/or use the software. 4) Follow the prompts to install the files. 5) The application will install the files in a directory called Turbocraft (in the Program Files directory by default), with a sub- directory called Subroutines. 6) Read the instruction manuals left by the installer in the individual subroutines directories for the details on how to use the software. II. Conventions ----------------------------------------- The subroutines are written in a consistent style: Action block: Aqua, Text: Arial 11 point black Connection: Black Decision block: Yellow, Text: Arial 11 point black Red false exit Blue true exit Continue block: Orange, Text: Arial 11 point black General Text: Arial 12 point black Grid color: Black Background color: Light gray (R:192 G:192 B:192) In addition, block 0 is always white Most of these subroutines have two versions; The nominal version is a "debug" version complete with comments, some error handling, completion status, and an elapsed timer that lets you know how long it took to complete - the other version is a stripped down "turbo" version (ending in "_T") that has had most of the comments, and the error handling and timer removed for speed. Use the "debug" version until you are sure that you have solved any errors that occur, and that you are satisfied with the elapsed time. Then if you wish, substitute the "turbo" version to increase the execution speed. The subroutines are written without making use of any external commands. An instruction manual is provided in each subroutine's directory in Microsoft Word® 97 format. III. License Issues ----------------------------------------- -End User If you are an end user of this product, you are required to buy one license for each plant address that has an Opto 22 system that makes use of any part or all of this Turbocraft, Inc. software product. -Consultants and Systems Integrators If you are a consultant or systems integrator you must buy one license for every two computers that you have installed this Turbocraft, Inc. software product on, and in addition any customer of yours that makes use of any project that you create that has any part or all of this software product in it must also buy a license for each plant address that makes use of said project. -Governmental users If you are a governement agency that has purchased this product, you must buy a license for each plant address that makes use of any part or all of this Turbocraft, Inc. software product. You are allowed to make one backup copy of the software on removable media. This is only a partial summary description of the license agreement, and is not the license agreement itself. Read the details of the license agreement in Subroutines_License.txt which you must agree to in order to use this software. IV. Disclaimer ----------------------------------------- While reasonable effort is made to insure the correct functionality of the subroutines in this software product, it is provided in "as-is" condition, and Turbocraft, Inc. makes no warranty, implied or otherwise as to its operation, efficacy, functionality, speed, safety, correctness, or appropriateness. The end user uses this product at their own risk and assumes all responsibility for insuring that this product is appropriate for, and works correctly for their particular application. This is only a partial summary description of the disclaimer and is not the disclaimer itself. The instruction manuals also contains only a partial summary description of the disclaimer, and is not the disclaimer itself. See the license agreement Subroutines_License.txt which must accompany this product, and which contains the full text of the disclaimer, and which you must agree to in order to use this software. V. Trademarks and Copyrights ----------------------------------------- Opto 22 FactoryFloor is a registered trademark of Opto 22. OptoControl and OptoDisplay are trademarks of Opto 22. Microsoft Word is a registered trademark of Microsoft Corporation. © 2001, 2002 Turbocraft, Inc. ====================================================================== How to Get Help --------------- If you have any questions about this product, contact Turbocraft Product Support Monday through Friday, 9 a.m. to 6 p.m., Pacific Time. E-mail: support@turbocraft.com Phone: 1-866-Turbocraft (toll free in North America) (1-866-887-2627) 1-206-248-3597 (outside of North America) Fax: 206-248-3597 Please provide the following information about your system to the Product Support engineer: - Version of this product - FactoryFloor® version - Controller firmware version - Any specific error messages seen ===================================================================== Visit our web site at http://www.turbocraft.com =====================================================================