Command Line Manual
Contents
1. peProx Command Line Utility User Manual E C Program Files RF IDeas CmdpcProx CmdpcProxexe Lo Cl x CmdpcProx list CmdpcProx SetActDevu B 15 CmdpcProx vu verbose errors CmdpcProx HaltKbSend YesiNo CmdpcProx LedControl Autol Redl GreenJ AmberJ Off 1 CmdpcProx WriteConfig SaveToFile l huwgl CmdpcProx ReadConfig ReadFromFile l huwgl CmdpcProx Clone ReadFomrFile l hugl CmdpcProx GetActiveID s timestampl strftime 1 oneidl CmdpcProx WaitForgetActiveID SECONDS lt B 36008 gt asht gt or slash lt gt may precede switches Switches are not case sensitive xamples CmdpcProx HaltKbSend Y LEDControl1 0FF CmdpcProx ReadConfig SetupBB1 hug CmdpcProx writeCONFIG file name with spaces CmdpcProx get Activeld s 1 eee a ATENa i 18 CmdpcProx getactiveid Card xs CmdpcProx timestamp decimal epoc time CmdpcProx timestamp defaults to za m d 7Y Xx CmdpcProx timestamp za xx Press any key El www RFlDeas com 99009030a RF IDens Command Line pcProx Utility User Manual Thank You Congratulations on the purchase of the pcProx device RF IDeas hopes you enjoy using the new device as much as we enjoyed creating and developing it Please share your comments and suggestions for our future solutions If you are interested in our OEM or Independent Developer s Programs please call us Thank you T2. expected to employ a container equivalent to the original packaging Copyright Copyright by RF IDeas 1997 2009 All rights reserved Reproduction or distribution of this document in whole or in part or in any form is prohibited without express written permission from RF IDeas Trademarks All RF IDeas products are trademarks of RF IDeas All other product names or names are trademarks or registered trademarks of their respective holders Page 5 of 15 RF IDens Command Line pcProx Utility User Manual Disclaimer This Reference Guide is printed in the U S A Any resemblance mentioned in the Reference Guide to persons living or dead or to actual corporations or products is purely coincidental RF IDeas believes that the information contained in this manual is correct However RF IDeas does not assume any responsibility for the accuracy of the content of this User Manual nor for any patent infringements or other rights of third parties RF IDeas reserves the right to make any modifications in either product or the manual without giving prior written notification FCC Compliance Statement FCC ID MIMPCPROXHUSB100 HID USB model FCC ID MIMPCPROXH100 HID RS 232 model FCC ID MIMPCPROXM101 Indala model FCC ID M9MRDR6981 AWID FCC ID M9MRDR6881 Kantech Indala Casi Rusco FCC ID MOMPCPROXP100 Pyramid FCC ID MIMPCPROXC101 Casi Rusco model FCC ID M9MRDR6091 HID Low Power FCC ID M9MRFID13561100 MIFARE CLA
3. or its suppliers The PRODUCT and SOFTWARE PORTION OF 1 1 THE PRODUCT is protected by copyright laws and international treaty provisions You may not copy the printed materials accompanying the PRODUCT 5 DUAL MEDIA SOFTWARE You may receive the SOFTWARE PORTION OF THE PRODUCT in more than one medium Regardless 1 2 of the type or size of medium you receive you may use only one medium that is appropriate for your single computer You may not use or install the other medium on another computer You may not loan rent lease or otherwise transfer the other medium to another user except as part of the permanent transfer as provided above of the SOFTWARE PORTION OF THE PRODUCT FOR THE LIMITED WARRANTIES AND SPECIAL PROVISIONS PERTAINING TO YOUR PARTICULAR JURISDICTION PLEASE REFER TO YOUR WARRANTY BOOKLET INCLUDED WITH THIS PACKAGE OR PROVIDED WITH THE SOFTWARE PRODUCT PRINTED MATERIALS Limited Warranty RF IDeas warrants to the original buyer of this product that the hardware and related disk s are free of defects in material and workmanship for a period of one year from date of purchase from RF IDeas or from an authorized RF IDeas dealer Should the RF IDeas products fail to be in good working order at any time during the one year period RF IDeas will at its option repair or replace the product at no additional charge provided that the product has not been abused misused repaired or modified This warranty shall be limited to repair or repla
4. port 2 Run cmdpcprox writeconfig master The configuration is read and the master hwg file is created 3 Unplug the master device from the USB port Enter cmdpcprox clone master to clone multiple devices with this configuration Page 10 of 15 RF iDeas Command Line pcProx Utility User Manual When the utility finds 1 to 16 devices they will be configured exactly as the master device This same master hwg file is saved to device s memory The device LED flickers while the file is being written to flash memory EN C Windows system32 cmd exe CmdpcProx exe clone master c Program Files RF IDeas gt cd C Program Files RF Deas CmdpcProx 5 Program Files RF IDeas CmdpcProx gt CmdpceProx exe c lone master his master hwg will be written to all the pcProx devices connected to the USB us pose ALL USB pcProx DEVICES ON THE BUS WILL BE CONFIGURED FROM master hug Press Control C to Exit or any key to continue to program devices Note The utility will timeout after 60 seconds of no activity Press Control C to exit the cloning loop Escape Sequence Several escape sequences can be used in the format strings of GetActivelD Appears in Format String Represents Hex Character IC ICI CAN Page 11 of 15 RF IDens Command Line pcProx Utility User Manual Timestamp Format Parameters input Os Example c Replaced by the locale s appropriate date and time Thu Feb 10 14
5. 55 02 representation 2009 C Replaced by the century the year divided by 100 and 19 truncated as a decimal integer 00 99 Replaced by the day of the month as a decimal number Equivalent to m d y 02 10 09 e Replaced by the day of the month as a decimal number a 1 to 31 single digit is preceded by a space F Equivalent to Y m d the ISO 8601 2000 02 10 09 standard date format g Replaced by the last 2 digits of the week based year as a 00 99 decimal number G Replaced by the week based year see below as a 1977 decimal number am Replace by a metes TSS S E r Replaced by the time in a m and p m notation in the POSIX 09 10 11 PM for locale this shall be equivalent to l M S p 21 10 11 Replaced by the time in 24 hour notation H M 00 43 for 12 43 AM Replaced by the second as a decimal number 00 60 00 through 59 Replaced by the time H M S 21 10 11 for 09 10 11 PM Page 12 of 15 RF IDens Command Line pcProx Utility User Manual 1 7 with 1 representing O Replaced by the weekday as a decimal number Monday Replaced by the week number of the year as a decimal U number 00 53 The first Sunday of January is the first day 33 of week 1 days in the new year before this are in week O w Replaced by the weekday as a decimal number with 4 O representing Sunday 0 6 Replaced by the week number of the year Monday as the first day of the week as a decimal num
6. Deas shall not be liable for losses due to failure of any of these products or components of these products beyond the RF IDeas commercial warranty limited to the original purchase price SOFTWARE PRODUCT LICENSE The PRODUCT is protected by copyright laws and international copyright treaties as well as other intellectual property laws and treaties The SOFTWARE PORTION OF THE PRODUCT is licensed not sold 1 GRANT OF LICENSE This EULA grants you the following rights Software You may install and use one copy of the SOFTWARE PORTION OF THE PRODUCT on the COMPUTER Network Services If the SOFTWARE PORTION OF THE PRODUCT includes functionality that enables the COMPUTER to act as a network server any number of computers or workstations may access or otherwise utilize the basic network services of that server The basic network services are more fully described in the printed materials accompanying the SOFTWARE PORTION OF THE PRODUCT Storage Network Use You may also store or install a copy of the computer SOFTWARE PORTION OF THE PRODUCT on the COMPUTER to allow your other computers to use the SOFTWARE PORTION OF THE PRODUCT over an internal network and distribute the SOFTWARE PORTION OF THE PRODUCT to your other computers over an internal network 1 1 General License Grant RF IDeas grants to you as an individual a personal nonexclusive license to make and use copies of the SOFTWARE PRODUCT for the sole purposes of designing developing a
7. SS models FCC ID M9MRDR7L81 Legic 13 56MHz FCC ID M9MRDR7081 CLASS Module based FCC ID M9MRDR7181 CLASS MIFARE and Other 13 56Mhz FCC ID M9MRDR7581 CLASS MIFARE and Other 13 56Mhz FCC ID MOMRDR7081AKF CLASS MIFARE and Other 13 56Mhz FCC ID M9MRDR7081AKE CLASS MIFARE and Other 13 56Mhz Attention Changes to this reader system not expressly approved by RF IDeas will void the User s authority to operate the equipment Note This device complies with Part 15 of the FCC Rules Operation is subject to the following two conditions 1 This device may not cause harmful interference and 2 this device must accept any interference received including interference that may cause undesired operation This product complies with FCC OET Bulletin 65 radiation exposure limits set forth for an uncontrolled environment The reader may not recognize value cards in the presence of high RF fields If the current reading is erratic the user shall take the following step Move the equipment from any known transmitters nearby For more information contact Tech Support at 866 439 4884 Page 6 of 15 RF IDens Command Line pcProx Utility User Manual Introduction The simple command line interface cmdpcProx exe is used to configure the pcProx card reader without the complexity of C C NET or VB BATCH files bat CMD files CMD and other scripting languages such as Python PERL Ruby C C and Visual Basic can be used
8. a File Edit Format View Help Python example of reading a card using cmdpcprox import os string time Invoke utility and read its standard output of epoc timestamp and card data fd os popen cmdpcprox timestamp getactiveid s s fd readO fd closeQ Split time and card data field on colon since we used print s ss i t time ctime string atol ss 0 show results print t ss 1 4 Page 14 of 15 waitforgetactiveid 10 s on the switch RF Deas Command Line pcProx Utility User Manual Command Line Parameters Parameters may be preceded with a or Unix or Windows style All names are not case sensitive so all lower all upper or mixed case spelling may be used Parameters are case preserved version list SetActDev 0 haltkbsend Y N getactiveid getactiveid Card is s oneid waitforgetactiveid NN timestamp timestamp ledcontrol off red green orange auto readconfig MyFile hwg writeconfig MyFile hwg clone Display program versions Show all devices found 0 127 Set active device number 0 127 default is device zero Enable or disable keystroke data Format card string When used with getactiveid wait for card data to go inactive before allowing utility to exit Number of seconds NN 0 3 600 waits this long for card data to be present Prints seconds since epoch time O Jan 1st 1970 For conve
9. ber 01 53 If the week containing 1 January has 4 or more days in the new year then it s considered week 1 Otherwise it s the 01 through 53 last week of the previous year and the next week is week 1 Both January 4th and the first Thursday of January are always in week 1 Replaced by the weekday as a decimal number 0 6 O with O representing Sunday e punesy Mo a Replaced by the week number of the year as a decimal W number 00 53 The first Monday of January is the first day of 43 week 1 days in the new year before this are in week 0 Replaced by the locale s appropriate date representation X j d pprap H 02 10 09 IEEE Std1 003 1 2001 Replaced by the locale s appropriate time representation X j el dei j 03 43 10 for 15 43 10 IEEEStd1 003 1 2001 Zz Replaced by the year as a decimal number for example 1997 2010 Replaced by the offset from UTC in the ISO 8601 2000 standard format hhmm or hhmm or by no characters if no Cowan 4 hours 30 timezone is determinable Z Replaced by the timezone name or abbreviation or CDT O A P A by no bytes if no timezone information exists Replaced by Page 13 of 15 Python Example Command Line pcProx Utility User Manual Since the utility returns standard output of the GefActivelD data string many other scripting languages can also retrieve data from the device This is a Python file example to read a card using cmdpcprox 3 example py Notepad lt
10. ble the Certificate s of Authenticity AND the recipient agrees to the terms of this EULA Ifthe PRODUCT is an upgrade any transfer must include all prior versions of the PRODUCT e Termination Without prejudice to any other rights RF IDeas may terminate this EULA if you fail to comply with the terms and conditions of this EULA In such event you must destroy all copies of the SOFTWARE PORTION OF THE PRODUCT and all of its component parts 3 UPGRADES If the SOFTWARE PORTION OF THE PRODUCT is an upgrade from another product whether from RF IDeas or another supplier you may use or transfer the PRODUCT only in conjunction with that upgraded product unless you destroy the upgraded product If the SOFTWARE PORTION OF THE PRODUCT is an upgrade of a RF IDeas product you now may use that upgraded product only in accordance with this EULA If the SOFTWARE PORTION OF THE PRODUCT is an upgrade of a component of a package of software programs which you licensed as a single product the SOFTWARE PORTION OF THE PRODUCT may be used and transferred only as part of that single product package and may not be separated for use on more than one computer 4 OEM COPYRIGHT All title and copyrights in and to the PRODUCT including but not limited to any images photographs animations video audio music text and applets incorporated into the PRODUCT the accompanying printed materials and any copies of the SOFTWARE PORTION OF THE PRODUCT are owned by RF IDeas
11. cement and in no event shall RF IDeas be liable for any loss of profit or any commercial or other damages including but not limited to special incidental consequential or other similar claims No dealer distributor company or person has been authorized to change or add to the terms of this agreement and RF IDeas will not be bound by any representation to the contrary RF IDeas SPECIFICALLY DISCLAIMS ALL OTHER WARRANTIES EXPRESSED OR IMPLIED INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS OF PURPOSE Since some states do not allow such exclusion of limitation of incidental or consequential damages for consumer products check the statute of the state in which your business resides This warranty gives you the specific legal rights in addition to any rights that you have under the laws of the state in which your business resides or operates Returns RF Deas products which require Limited Warranty service during the warranty period shall be delivered to the nearest authorized dealer or sent directly to RF IDeas at the address below with proof of purchase and a Return Materials Authorization RMA Number provided by RF IDeas Technical Support Dept Replacement parts or complete boards become the property of RF IDeas If the returned board or unit is sent by mail the purchaser agrees to pre pay the shipping charges and insure the board or unit or assume the risk of loss or damage which may occur in transit The purchaser is
12. d RF IDeas from and against Page 4 of 15 RF IDens Command Line pcProx Utility User Manual any claims or lawsuits including attorney s fees that arise or result from the use or distribution of the Licensed Product e otherwise comply with the terms of this EULA and g agree that RF IDeas reserves all rights not expressly granted You also agree not to permit further distribution of the Redistributables by your end users except 1 you may permit further redistribution of the Redistributables by your distributors to your end user customers if your distributors only distribute the Redistributables in conjunction with and as part of the Licensed Product and you and your distributors comply with all other terms of this EULA and 2 in the manner described in Section 1 4 Separation of Components The PRODUCT is licensed as a single product lts component parts may not be separated for use on more than one computer Single COMPUTER The PRODUCT is licensed with the COMPUTER as a single integrated product The PRODUCT may only be used with the COMPUTER Rental You may not rent or lease the PRODUCT without permission from RF IDeas Software Transfer You may permanently transfer all of your rights under this EULA only as part of a sale or transfer of the COMPUTER provided you retain no copies you transfer all of the PRODUCT including all component parts the media and printed materials any upgrades this EULA and if applica
13. entified above PRODUCT The PRODUCT includes the RF IDeas reader computer software the associated media any printed materials and any on line or electronic documentation By installing copying or otherwise using the PRODUCT you agree to be bound by the terms of this EULA The SOFTWARE PORTION OF THE PRODUCT includes the computer software the associated media any printed materials and any on line or electronic documentation By installing copying or otherwise using the PRODUCT you agree to be bound by the terms of this EULA If you do not agree to the terms of this EULA RF IDeas is unwilling to license the PRODUCT to you In such event you may not use or copy the SOFTWARE PORTION OF THE PRODUCT and you should promptly contact the vendor you obtained this PRODUCT from for instructions on return of the unused product s for a refund The products described in this publication are intended for consumer applications RF IDeas assumes no liability for the performance of product RF IDeas products are not suitable for use in life support applications biological hazard applications nuclear control applications or radioactive areas None of these products or components software or hardware are intended for applications that provide life support or any critical function necessary for the support of protection of life property or business interests The user assumes responsibility for the use of any of these products in any such application RF I
14. he RF Deas Staff Need Assistance Call 847 870 1723 Fax 847 483 1129 E mail Sales RF IDeas com TechSuppORFlDeas com Mail to RF IDeas 42388 Arlington Heights Road Suite 244 Arlington Heights Illinois 60004 Page 2 of 15 Table of Contents TOM A oie Moen dea iros 2 End User License Agreda ides noa ee Era e a a an E aparine Kian erkei echek Eai 4 A PAESE A E EEE ETA A E E AEE 7 ARS EEE E E A E EA T A TE E AAEE 8 O 9 Examples dat A ES ae ae 9 Configure M litple DeviCOS ou o 11 Escape EQU Ceac aaa aia nudes 12 Timestamp Format Paramete rs cccccccecceccaeeeeeeeeeeeeeeeeeeeeeeeaaaaeaaeeeeeeeeeeeeeesaaeeeeseaeeeesaanees 12 IIPU ts visa ranas irte dia 12 QUtPUE 00 AS rae Beenie ie E A ee Or 12 Python EXA A A AA A a AE a 14 Command Line Parameters ccccccccecceeceecceeceeceecueececceeeceeceeeeeeueeceeeeaeeeeeeaeeaeeeeeseeeeaeeeeaeeesaeenenees 15 RF IDens Command Line pcProx Utility User Manual End User License Agreement LICENSE AGREEMENT End User License Agreement for RF IDeas SOFTWARE and HARDWARE RF IDeas pcProx AIR ID Proximity Activated Readers Software Developer s Kit and Proximity Reader DLLs and Protocol s IMPORTANT READ CAREFULLY This End User License Agreement EULA is a legal agreement between you either an individual or a single entity and the manufacturer RF IDeas Manufacturer with which you acquired the RF IDeas software and hardware product s id
15. mestamp strftime oneid cmdpcprox WaitForgetActivelD SECONDS 0 3600 dash or slash may be before parameters Switches are not case sensitive Examples cmdpcprox HaltKbSend Y LEDControl OFF cmdpcprox ReadConfig Setup001 hwg cmdpcprox getactiveid Card s cmdpcprox timestamp a X Page 8 of 15 RF IDens Command Line pcProx Utility User Manual Examples Let s start with a simple command Example 1 The device should send keystrokes only when Notepad is running When Notepad is closed no card data should be typed into the active window application Notify users when the device is active using two switches 1 haltkbsend y 2 ledcontrol off Note Set haltkbsend n initially so all keystrokes are sent via the device Enter the parameters cmdpcprox haltkbsend n ledcontrol auto start wait Notepad cmdpcprox haltkbsend y ledcontrol off The first command sends keystrokes to the active window application and sets the LED control to automatic which by default is red when ready and green when active data is present The color of the LED indicates if the device is actively sending to Notepad The second command opens Notepad The WAIT parameter stops the utility from performing the next command immediately The third command stops sending keystrokes and turns off the LED when Notepad is closed Example 2 The device must type keystrokes to a specific customer application A log of the card da
16. nd testing your software product s that are designed to operate in conjunction with any RF IDeas designed proximity reader product You may install copies of the SOFTWARE PRODUCT on an unlimited number of computers provided that you are the only individual using the SOFTWARE PRODUCT If you are an entity RF IDeas grants you the right to designate one individual within your organization to have the sole right to use the SOFTWARE PRODUCT in the manner provided above 1 2 Documentation This EULA grants you as an individual a personal nonexclusive license to make and use an unlimited number of copies of any documentation provided that such copies shall be used only for personal purposes and are not to be republished or distributed either in hard copy or electronic form beyond the user s premises and with the following exception you may use documentation identified in the SOFTWARE PRODUCT as the file format specification for RF IDeas proximity readers solely in connection with your development of software product s or an integrated work or product suite whose components include one or more general purpose software products 1 3 Storage Network Use You may also store or install a copy of the SOFTWARE PRODUCT on a storage device such as a network server used only to install or run the SOFTWARE PRODUCT on computers used by a licensed end user in accordance with Section 1 1 Asingle license for the SOFTWARE PRODUCT may not be shared or used concurrently b
17. nience same as timestanp a Yom Y d Y Y YX Must be one of the five values Auto is the factory default Reads ASCII Hog file and writes setting into device memory Save device memory setting into ASCII file Prompting waiting and writing setup file into all pcProx devices on USB bus Page 15 of 15
18. ta read and a time date stamp on each card read must be typed into the specific customer application Here Notepad as the active application Note Set haltkbsend N so the keystrokes display in Notepad Enter the parameters cmdpcprox GetActivelD Card Data BEGIN s END The utility displays card data when the LED is green The device can be configured to wait between 1 and 3 600 seconds for card data The following example configures the device to wait 10 seconds for data The s represents the card string cmdpcprox GetActivelD Card Data BEGIN s END waitforGetActivelD 10 oneid Page 9 of 15 RF Dens Command Line pcProx Utility User Manual The utility prints Card Data BEGIN 87 BA 54 00 00 00 END Note Standard C printf formating may be used such as 9 9s Enter the parameters Start Notepad cmdpcProx haltkbsend n getactiveid Card read s n oneid waitforgetactiveid 10 timestamp X gt gt logfile txt The device types the keystrokes into Notepad The API function call returns the data The n in the parameter of the GefActivelD represents a newline ASCII Line Feed Ox0a The oneid parameter causes the utility to wait until the card is inactive before exiting the utility e The time stamp always prints before the card data Configure Mulitple Devices To program multiple devices with the same configuration 1 Connect the master device that has the configuration to clone to the USB
19. to configure the device to e Enable or disable sending keystrokes to active window application e Control the color and functionality of the LED e Save and restore device settings e Read cards using GetActivelD function e Wait N seconds for active card data e Provide an optional user defined time stamp string e Clone device setup to a USB hub of devices Command line parameters to the utility control the device and the card data The data can display in the active window application standard output or be redirected to a file The device displays card data in two ways 1 The device emulates a keyboard and types the keystrokes to the active window application 5 Untitled Notepad ll e File Edit Format View Help 12 1888 2 The device displays the card data as a string of 8 hexadecimal bytes EN Command Prompt Ses E Progran Files RF IDeas GndpcProx cndpeprox getactiveid card ard 50 68 13 00 AO AB BA AB Progran Files RF IDeasWCndpcProx Page 7 of 15 RF IDens Command Line pcProx Utility User Manual Get Started Verify C Program Files RF Ideas Cmdpcprox is in your path This runs as a command line utility under Windows The operating systems that support this utility are Windows 95 98 2000 XP or Vista Usage Run the cmdpeprox utility without parameters to display the Help usage See the examples below Usage switch value cmdpcprox GetActivelD s ti
20. y other end users 1 4 Sample Code RF IDeas grants you the right to use and modify the source code version of those portions of the SOFTWARE PRODUCT identified as Samples in the SOFTWARE PRODUCT Sample Code for the sole purposes of designing developing and testing your software product s and to reproduce and distribute the Sample Code along with any modifications thereof only in object code form DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS Limitations on Reverse Engineering Decompilation and Disassembly You may not reverse engineer decompile or disassemble the PRODUCT except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation e You may not reproduce or otherwise emulate in whole or in part any form the protocol s defined within this PRODUCT for use without a RF IDeas PRODUCT e Redistributable Code If you are authorized and choose to redistribute Sample Code Redistributables as described in Section 1 4 you agree to a distribute the Redistributables in object code only in conjunction with and as a part of a software application product developed by you using the PRODUCT accompanying this EULA that adds significant and primary functionality to the SOFTWARE PRODUCT Licensed Product b not use RF IDeas name logo or trademarks to market the Licensed Product c include a valid copyright notice on the Licensed Product d indemnify hold harmless and defen
Download Pdf Manuals
Related Search