Somi-t sCOM Manual English version
Contents
1. Somi t inc sCOM 3 PREAMBLE This manual assumes you have basic knowledge about the FileMaker Pro database development platform the use of plug in with external functions and custom functions This manual as well as files that are included are provided under license of agreement and may not be copied photocopied reproduced translated or converted to electronic format in whole or in part without written permission in advance from Somi t Inc FileMaker used in the descriptions in this manual generally refers to software versions FileMaker Pro and FileMaker Pro Advanced Somi t Inc is a proud FileMaker Business Alliance FBA member since 2006 Does Somi t Inc assumes no liability for errors or inaccuracies in this manual Do not hesitate to contact us at guideinfo somi t com Web site http www somi t com or http www FollowTheGuide ca Last update made to this manual June 27th 2012 for version 1 0 of sCOM plug in INTRODUCTION Summary The sCOM plug in allows your FileMaker Pro solution to communicate with serial devices using the Windows operating system After installing the sCOM plug in you can easily use the seven external functions that are automatically displayed in the calculation dialog box of FileMaker Pro Examples of use Open or close a relay on an USB Serial hardware relay GCE Electronics USB X220 for example to connect to an alarm system or an open close door management system Interact with2. ed Tools Small Office Management Integrat Somi t inc scOM
3. a telephone modem Control equipment with a serial or USB interface barcode reader or magnetic card reader balance cash drawer etc Plug in installation Note that the copy of sCOM plug in will display a message requesting registration of the copy after each five 5 uses of functions sCOM_Write SCOM_Read and sCOM_WriteToRead You need to enable the sCOM plug in in your FileMaker Pro solution for its state to changes from Demonstrator to Registered Use the external function sCOM_Register in the file opening script of your the FileMaker Pro solution to activate your extension If you experience problems during the installation process you can contact our technical support using our Application form for assistance or information located in the support page of our website at www somi t com Somi t inc sCOM Summary of installation steps 1 The sODBC fmx plug in must be located under C Program Files FileMaker FileMaker Pro version Extensions folder before opening FileMaker Pro 2 The external functions of sCOM plug in are now available using external functions of FileMaker Pro Somi t inc sCOM EXTERNAL FUNCTIONS List of external functions for sCOM plug in sCOM_Dcb ParamName Value sCOM_Read ComName NumBytesToRead sCOM_Register Name Key sCOM_Timeouts ReadIntervalTimeout ReadTotalTimeoutMultiplier ReadTotalTimeoutConstant WriteTotalTimeoutMultiplier Writ
4. User Manual sCOM Plug in Somit a Small Office Management Integrated Tools USER MANUAL OF sCOM PLUG IN FOR FILEMAKER PRO By Henri and Mathieu Frappier 2012 Somi t inc All right reserved Somi t inc sCOM TABLE OF CONTENT PREAMBLE srncie nenea aeaa TEE AEE eege 4 INTRODUCTION EE 4 SUMMA EE Error Bookmark not defined Examples TE 4 Plug in iMStallatio EE Error Bookmark not defined a TIR Eed el KE Error Bookmark not defined List of external functions for SCOM pDlug jn 6 sCOM_Deb gt ParamName 3 Value sic cciececassstecssesvversesssvecacosDececesusoesestuvestussdeensessderseusveests 6 sCOM_Read ComName NumBytesToRead cccssccceesssceceessececeeaeeeseesaeeeeeeaeeeesaas 6 sCOM Register Name Key cccssccssooccesscevesecvadecexescncesoeneseveed asbs sanvneedtus NEGER ZEN 7 sCOM_Timeouts ReadintervalTimeout ReadTotalTimeoutMultiplier ReadTotalTimeoutConstant WriteTotalTimeoutMultiplier WriteTotalTimeoutConstant 7 SCOM Versioni Format kl duet css diese cavineccasVavonssesdencedsh bN EaI EN Cias SEN RIS PENNE SES ISN ias SENEE 7 sCOM_Write ComName Data 7 sCOM_WriteToRead ComName Data NumBytesToRead ssssssssssssssssssesssesssesssesssessee 8 EELER 8 Technical MOLES Steeg et nts eege tee Eve ee Error Bookmark not defined Troubleshooting cecececssceeceesseeeeeeseeeeceeceeeeeeseeeeeeceeeeeeneeeenes Error Bookmark not defined About GUTE NIN EE 9
5. a NumBytesToRead Description This feature allows you to write to the selected communication port and make a subsequent reading Parameter Not used stay empty with ComName Parameter Name of the communication port Data Parameter Data to be written on the communication port NumBytesToRead Parameter Number of characters to read after write o Example sCOM_WriteToRead COM1 Hello World 5 Result Returns a code starting with if an error occurred otherwise returns the read character sCOM error codes and meaning Applicable only to functions sCOM_Write sSCOM_Read and sCOM_WriteToRead o l 1 Parameter error o 6 2 Error connecting to port E012_CreateFile_failed o l 3 Cannot change delay E013_SetCommTimeouts_failed o 4 Could not define the parameters for controlling communication with the device E014_SetCommState_failed Applicable only to functions sCOM_Write and sCOM_WriteToRead o l 5 x Writing error x_Unknown_error The value x may give different results Refer to http msdn microsoft com en us library windows desktop ms681381 aspx Applicable only to the sCOM_Register function o Error registering Recording error Wrong combination of name and registration key o HInvalid Key Recording error Wrong registration key Somi t inc sCOM REFERENCES Technical notes The sCOM plug in requires the operating system Microsoft Wind
6. eTotalTimeoutConstant sCOM_Version Format sCOM_Write ComName Data sCOM_WriteToRead ComName Data NumBytesToRead sCOM_Dcb ParamName Value Description This feature allows you to control various communication parameters such as speed and XON XOFF Parameter Not used stay empty with ParamName Parameter Parameter name to change Value Parameter New parameter value o Example sCOM_Dcb BaudRate 14400 Note For more information please visit the following website http msdn microsoft com en us library windows desktop aa363214 aspx sCOM_Read ComName NumBytesToRead Description This function reads the selected communication port Parameter Not used stay empty with ComName Parameter Name of the communication port NumBytesToRead Parameter Number of characters to read o Example sCOM_Read COM1i 5 Result Returns a code starting with if an error occurred otherwise returns the read character Somi t inc sCOM sCOM_Register Name Key Description Activate the plug in Name Parameter Name of the organisation you provided to Somi t for the registration of the plug in Key Parameter Registration key provided by Somi t sCOM_Timeouts ReadIntervalTimeout ReadTotalTimeoutMultiplier ReadTotalTimeoutConstant WriteTotalTimeoutMultiplier WriteTotalTimeoutConstant Description This function changes t
7. he delay related to a writing and reading operation to the communication used port The default values are respectively 1 1 100 0 0 Parameter Not used stay empty with ReadIntervalTimeout Parameter Delay in milliseconds ReadTotalTimeoutMultiplier Parameter Delay in milliseconds ReadTotalTimeoutConstant Parameter Delay in milliseconds WriteTotalTimeoutMultiplier Parameter Delay in milliseconds WriteTotalTimeoutConstant Parameter Delay in milliseconds o Example sCOM_Timeouts 10 10 100 1 1 Note For more information please visit the following website http msdn microsoft com en us library windows desktop aa363190 aspx sCOM_Version Format Description Indicates the version of the plug in Format Parameter long Returns the extension name and version short returns only the version of the plug in o Example sCOM_Version sCOM_Version long Result Returns the version of the plug in sCOM_Write ComName Data Description This feature allows you to write to the selected communication port Parameter Not used stay empty with Somi t inc sCOM ComName Parameter Name of the communication port Data Parameter Data to be written on the communication port o Example sCOM_Write COM1 Hello World Result Returns a code starting with if an error occurred otherwise returns nothing sCOM_WriteToRead ComName Dat
8. ows XP or later The sCOM plug in is compatible with versions 9 10 11 and 12 of FileMaker Pro and FileMaker Pro Advanced The sCOM plug in is compatible with FileMaker Server side scripting SSS technology It can communicate with multiple ports in the same script The maximum transmission speed when connected is 256 000 bps There is no memory buffering with sCOM plug in sSCOM_Read and sCOM_WriteToRead functions are using a parameter that determines how many bytes to read Troubleshooting As this is the first user manual for SCOM plug in for FileMaker Pro we invite users to communicate with us to help us build this section of the manual About FileMaker Inc FileMaker develops database program awards since 1990 Its products include the legendary FileMaker Pro product line for Windows Mac and FileMaker Go for iPhone iPod and iPad FileMaker has won over 52 awards more than his eight competitors combined from 2003 to 2009 in the United States and a total of 134 awards in the world during those years Millions of users from individuals to large companies rely on FileMaker to manage analyze and share information FileMaker Inc is a subsidiary of Apple Inc Somi t inc sCOM Somi t inc 550 Sherbrooke West Suite 200 Montreal QC H3A 1B9 CANADA T 514 906 1448 1 866 SOMITCOM 766 4826 INTL 883 5100 01 393883 F 514 906 1449 guideinfo somi t com www somi t com www FollowTheGuide ca Somit 4a
Download Pdf Manuals
Related Search