JOY-IT POKEYS57E User guide

Version: 21/12/2016
User’s manual
2
www.poscope.com
Please read the following notes
1. All information included in this document is current as of the date this document is issued. Such information, however,
is subject to change without any prior notice.
2. PoLabs does not assume any liability for infringement of patents, copyrights, or other intellectual property rights of
third parties by or arising from the use of PoLabs products or technical information described in this document. No license, express, implied or otherwise, is granted hereby under any patents, copyrights or other intellectual property rights of PoLabs or others. PoLabs claims the copyright of, and retains the rights to, all material (software, documents, etc.) contained in this release. You may copy and distribute the entire release in its original state, but must not copy individual items within the release other than for backup purposes.
3. Descriptions of circuits, software and other related information in this document are provided only to illustrate the
operation of the products and application examples. You are fully responsible for the incorporation of these circuits, software, and information in the design of your equipment. PoLabs assumes no responsibility for any losses incurred by you or third parties arising from the use of these circuits, software, or information.
4. PoLabs has used reasonable care in preparing the information included in this document, but PoLabs does not warrant
that such information is error free. PoLabs assumes no liability whatsoever for any damages incurred by you resulting from errors in or omissions from the information included herein.
5. PoLabs devices may be used in equipment that does not impose a threat to human life in case of the malfunctioning,
such as: computer interfaces, office equipment, communications equipment, test and measurement equipment, audio and visual equipment, home electronic appliances, machine tools, personal electronic equipment, and industrial robots.
6. Measures such as fail-safe function and redundant design should be taken to ensure reliability and safety when PoLabs
devices are used for or in connection with equipment that requires higher reliability, for example: traffic control systems, anti-disaster systems, anticrime systems, safety equipment, medical equipment not specifically designed for life support, and other similar applications.
7. PoLabs devices shall not be used for or in connection with equipment that requires an extremely high level of reliability
and safety, as for example: aircraft systems, aerospace equipment, nuclear reactor control systems, medical equipment or systems for life support (e.g. artificial life support devices or systems), and any other applications or purposes that pose a direct threat to human life.
8. You should use the PoLabs products described in this document within the range specified by PoLabs, especially with
respect to the maximum rating, operating supply voltage range and other product characteristics. PoLabs shall have no liability for malfunctions or damages arising out of the use of PoLabs products beyond such specified ranges.
9. Although PoLabs endeavors to improve the quality and reliability of its products, semiconductor products have specific
characteristics such as the occurrence of failure at a certain rate and malfunctions under certain use conditions. Further, PoLabs products are not subject to radiation resistance design. Please be sure to implement safety measures to guard them against the possibility of physical injury, and injury or damage caused by fire in the event of the failure of a PoLabs product, such as safety design for hardware and software including but not limited to redundancy, fire control and malfunction prevention, appropriate treatment for aging degradation or any other appropriate measures.
10. Usage: the software in this release is for use only with PoLabs products or with data collected using PoLabs products.
11. Fitness for purpose: no two applications are the same, so PoLabs cannot guarantee that its equipment or software is
suitable for a given application. It is therefore the user's responsibility to ensure that the product is suitable for the user's application.
12. Viruses: this software was continuously monitored for viruses during production, however the user is responsible for
virus checking the software once it is installed.
13. Upgrades: we provide upgrades, free of charge, from our web site at www.poscope.com. We reserve the right to charge
for updates or replacements sent out on physical media.
14. Please contact a PoLabs support for details as to environmental matters such as the environmental compatibility of
each PoLabs product. Please use PoLabs products in compliance with all applicable laws and regulations that regulate the inclusion or use of controlled substances, including without limitation, the EU RoHS Directive. PoLabs assumes no liability for damages or losses occurring as a result of your noncompliance with applicable laws and regulations.
15. Please contact a PoLabs support at support.poscope.com if you have any questions regarding the information contained
in this document or PoLabs products, or if you have any other inquiries.
16. The licensee agrees to allow access to this software only to persons who have been informed of and agree to abide by
these conditions.
17. Trademarks: Windows is a registered trademark of Microsoft Corporation. PoKeys, PoKeys55, PoKeys56U, PoKeys56E,
PoKeys57U, PoKeys57E, PoKeys57CNC, PoScope, PoLabs and others are internationally registered trademarks.
3
www.poscope.com
Contents
1. Description ...................................................................................................................................... 8
2. Features ........................................................................................................................................... 9
2.1. PoKeys55 ................................................................................................................................. 9
2.2. PoKeys56U / PoKeys57U ......................................................................................................... 9
2.3. PoKeys56E / PoKeys57E ........................................................................................................ 10
3. Device comparison ........................................................................................................................ 11
4. Device hardware description......................................................................................................... 12
4.1. PoKeys56U/E pin functions graphical overview .................................................................... 16
4.2. PoKeys55 pin functions graphical overview (serial numbers above 11500) ......................... 16
4.3. Status LEDs ............................................................................................................................ 17
5. Requirements ................................................................................................................................ 18
5.1. USB devices ........................................................................................................................... 18
5.2. Network devices .................................................................................................................... 18
PoKeys57E v1.2 .............................................................................................................................. 18
PoKeys56E/PoKeys57E v1.1 .......................................................................................................... 18
6. Technical specifications ................................................................................................................. 19
6.1. PoKeys55, PoKeys56U and PoKeys57U dimensions .............................................................. 19
6.2. PoKeys56E/57E dimensions .................................................................................................. 20
6.3. Electrical specification – limiting values ................................................................................ 21
6.4. Electrical specification – static characteristic ........................................................................ 21
6.5. Environment specifications ................................................................................................... 21
6.6. Power supply for PoKeys57E v1.2 ......................................................................................... 22
6.7. Power supply for PoKeys56E (and PoKeys57E v1.1) ............................................................. 22
7. Installation ..................................................................................................................................... 23
8. PoKeys configuration options ........................................................................................................ 24
8.1. Digital inputs and outputs ..................................................................................................... 24
PoKeys configuration software usage ........................................................................................... 24
Applicable PoKeys library commands ........................................................................................... 29
8.2. Connection signal output ...................................................................................................... 30
PoKeys configuration software usage ........................................................................................... 31
Applicable PoKeys library commands ........................................................................................... 31
8.3. Digital counters (only on PoKeys56 devices) ......................................................................... 32
PoKeys configuration software usage ........................................................................................... 32
4
www.poscope.com
Applicable PoKeys library commands ........................................................................................... 32
8.4. Encoders ................................................................................................................................ 34
PoKeys configuration software usage ........................................................................................... 34
Applicable PoKeys library commands ........................................................................................... 36
8.5. Matrix keyboard .................................................................................................................... 38
PoKeys configuration software usage ........................................................................................... 38
Applicable PoKeys library commands ........................................................................................... 40
8.6. Analog inputs ......................................................................................................................... 41
PoKeys configuration software usage ........................................................................................... 41
Applicable PoKeys library commands ........................................................................................... 42
8.7. Joystick mapping ................................................................................................................... 43
PoKeys configuration software usage ........................................................................................... 43
Applicable PoKeys library commands ........................................................................................... 44
8.8. PWM outputs ........................................................................................................................ 45
PoKeys configuration software usage ........................................................................................... 45
Applicable PoKeys library commands ........................................................................................... 46
8.9. Matrix LED output ................................................................................................................. 47
PoKeys configuration software usage ........................................................................................... 48
Applicable PoKeys library commands ........................................................................................... 48
8.10. LCD ..................................................................................................................................... 49
PoKeys configuration software usage ........................................................................................... 50
Applicable PoKeys library commands ........................................................................................... 51
8.11. PoExtBus ............................................................................................................................ 52
PoKeys configuration software usage ........................................................................................... 53
Applicable PoKeys library commands ........................................................................................... 54
PoExtBus connector type .............................................................................................................. 54
8.12. PoNET ................................................................................................................................ 55
Adding new devices ....................................................................................................................... 55
PoNET kb48CNC keyboard............................................................................................................. 56
PoNET/PoExtBus connection example .......................................................................................... 57
Applicable PoKeys library commands ........................................................................................... 57
8.13. Failsafe settings ................................................................................................................. 59
Applicable PoKeys library commands ........................................................................................... 59
8.14. I2C protocol ........................................................................................................................ 60
5
www.poscope.com
Applicable PoKeys library commands ........................................................................................... 60
8.15. 1-wire ................................................................................................................................. 62
Applicable PoKeys library commands ........................................................................................... 62
8.16. Sensors .............................................................................................................................. 63
I2C sensors ..................................................................................................................................... 63
1-wire sensors ............................................................................................................................... 65
Analog sensors ............................................................................................................................... 66
Applicable PoKeys library commands ........................................................................................... 67
8.17. EasySensors ....................................................................................................................... 68
EasySensors configuration dialog .................................................................................................. 68
Scan for I2C sensors ....................................................................................................................... 68
Scan for 1-wire sensors ................................................................................................................. 69
Add DHTxx 1-Wire sensor .............................................................................................................. 69
Add analog sensor ......................................................................................................................... 69
List of supported sensors .............................................................................................................. 71
8.18. USB interface configuration .............................................................................................. 72
Start options .................................................................................................................................. 72
Communication interval ................................................................................................................ 72
Enabling/disabling the interfaces .................................................................................................. 73
8.19. PoKeys56E and PoKeys57E ................................................................................................ 74
Connecting to PoKeys56E/57E device for the first time ............................................................... 74
Device discovery ............................................................................................................................ 74
Default settings ............................................................................................................................. 75
Connecting to device in other network ......................................................................................... 75
Security .......................................................................................................................................... 75
Web interface ................................................................................................................................ 77
Modbus .......................................................................................................................................... 80
Connecting to PoKeys56E/57E across the internet ....................................................................... 82
Using PoKeys software with PoKeys56E/57E device across the internet ..................................... 83
8.20. Reporting data to network server with PoKeys56E/57E device ........................................ 84
Setup for Xively web service.......................................................................................................... 85
Setup for standard HTTP POST or PUT data upload ...................................................................... 87
8.21. Changing User ID number ................................................................................................. 88
8.22. Saving current configuration to file ................................................................................... 89
6
www.poscope.com
9. PoTLog27 firmware ....................................................................................................................... 89
10. Communicating with the USB devices using the console ......... Napaka! Zaznamek ni definiran.
10.1. Supported operations ........................................................ Napaka! Zaznamek ni definiran.
11. Connecting common peripherals to PoKeys devices ................................................................ 92
12. Restoring factory defaults - quick resetting the device configuration (or recovering bad
firmware update) .................................................................................................................................. 98
13. Frequently asked questions ...................................................................................................... 99
14. PoKeys library functions .......................................................................................................... 103
14.1. ConnectToDevice (universal for all PoKeys devices) ....................................................... 103
14.2. EnumerateDevices (for USB-based PoKeys devices) ....................................................... 103
14.3. ConnectToDevice (for USB-based PoKeys devices) ......................................................... 103
14.4. DisconnectDevice ............................................................................................................ 104
14.5. StartEthernetDiscovery ................................................................................................... 104
14.6. StopEthernetDiscovery .................................................................................................... 104
14.7. GetNumberOfDetectedNetworkDevices ......................................................................... 105
14.8. ConnectToNetworkDevice ............................................................................................... 105
14.9. GetDeviceIDEx ................................................................................................................. 105
14.10. GetUserID ........................................................................................................................ 106
14.11. SetUserID ......................................................................................................................... 106
14.12. SetPinData ....................................................................................................................... 106
14.13. SetPinData ....................................................................................................................... 107
14.14. GetPinData ...................................................................................................................... 108
14.15. GetPinData ...................................................................................................................... 109
14.16. GetInput........................................................................................................................... 109
14.17. SetOutput ........................................................................................................................ 110
14.18. GetAnalogInput ............................................................................................................... 110
14.19. SaveConfiguration ........................................................................................................... 111
14.20. GetMatrixConfiguration .................................................................................................. 111
14.21. SetMatrixConfiguration ................................................................................................... 113
14.22. GetPWMOutputs ............................................................................................................. 114
14.23. SetPWMOutputs .............................................................................................................. 115
15. Interfacing with PoKeys library – C# example ......................................................................... 117
16. Major changes from 1.x to 1.7: ............................................................................................... 126
16.1. Pin 13 not functioning appropriately .............................................................................. 126
7
www.poscope.com
16.2. Putting pin 4 low on startup disables PoKeys55 device from booting. ........................... 126
17. Errata information ................................................................................................................... 127
Pins 5 and 6 cannot be separately set as outputs/inputs ........................................................... 127
Wrong power supply was specified for PoNET connector in the documentation ...................... 127
Stepper motor outputs of the internal pulse generator don’t generate proper step signals for
axes y and z. ................................................................................................................................. 127
18. Grant of license ....................................................................................................................... 128
8
www.poscope.com

1. Description

PoKeys products line consists of simple, easy-to-use USB and network devices with the extended list of features making them powerful input/output devices. PoKeys55, PoKeys56U and PoKeys57U devices also incorporate a virtual USB keyboard and joystick with a simple setup. PoKeys devices enable user to design specially built robust computer interfaces. The devices are highly adjustable and as such require no complex knowledge on device programming. Virtual USB keyboard supports emulation of single key presses or various programmable series of keys (keyboard macro sequences) while virtual USB joystick emulation supports mapping of analog inputs to joystick axes and mapping of digital inputs to joystick buttons. All peripherals can be tested via included software with highly intuitive graphical user interface. Chosen settings can be stored on device, so no special software is needed on target system.
If additional input and output capabilities are needed, the devices provide 55 digital 5V tolerant inputs or outputs, 5 10-bit analog inputs (on PoKeys55) / 7 12-bit analog inputs (on PoKeys56 and PoKeys57 series devices) with adjustable software low-pass filter and one 10-bit analog output (on PoKeys55). These are complemented with 6 high-speed fully configurable PWM (pulse width modulation) outputs. User can freely set PWM period and PWM duty cycles. PWM module runs at 12 MHz (on PoKeys55) / 25 MHz (on PoKeys56 and PoKeys57 series devices) and allows high-speed output switching.
PoKeys devices also support up to 25 pairs of quadrature encoder signal inputs for which can be freely connected to any of the 55 inputs on PoKeys devices. These inputs increment or decrement the counters that can be read via provided software of other third-party applications. Changes in those signals can trigger virtual keyboard presses on USB versions of PoKeys devices. PoKeys devices also support three additional fast encoders, when higher frequencies of the quadrature encoder signals are in use. PoKeys56 and PoKeys57 series devices add additional support for one ultra-fast quadrature encoder signal that can handle even greater frequencies of these signals with ease.
In the cases when the application requires more than 55 inputs or outputs, PoKeys devices have the inbuilt support for matrix keyboards sized up to 16x8 with freely assignable key codes for virtual USB keyboard, while the PoExtBus bus feature adds the support for additional 80 digital outputs.
PoKeys devices also support hd44780-compatible character LCD displays and two serially driven 8x8 matrix LED displays.
Third-party application developers that are adding the support for PoKeys devices, are encouraged to use the supplied communication DLL that can be simply used in the different .NET framework based applications and various other programming languages that provide support for ActiveX interface. There is even an open-source cross-platform C library available at https://bitbucket.org/mbosnak/pokeyslib.
To aid developers that are communicating with PoKeys devices on the low-level, the extensive documentation on device communication protocol can be downloaded free of charge from the product webpage.
9
www.poscope.com

2. Features

2.1. PoKeys55

- Compatible with USB 1.1/2.0 HID standard
- Standard English USB keyboard simulation (with triggering support for up/down keys)
- Standard USB joystick simulation (6 axis, 32 buttons with triggering support)
- 55 digital inputs with pull-up resistors, freely mappable to virtual USB keyboard’s keys
- 55 software controlled digital outputs
- 5 analog inputs (10-bit), freely mappable to any of virtual USB joystick axes (with adjustable
low-pass filtering support)
- 1 software controlled 10-bit analog output, controlled via included software
- Up to 25 encoder pair inputs
- Up to 64 256-character long keyboard macro sequences
- Up to 16x8 matrix keyboard with triggered keys/alternate function support
- Two 8x8 matrix LED display support
- Up to 6 high-speed fully configurable PWM outputs support (12 MHz PWM timer)
- HD44780-based character LCD support (up to 4x20 characters)
- PoExtBus support for adding up to 10 external shift registers
- Support for Connection signal output
- Intuitive and user-friendly software
- Third-party support via communication DLL library and extensive protocol specification
document that allows porting to other systems

2.2. PoKeys56U / PoKeys57U

- Compatible with USB 1.1/2.0 HID standard
- Standard English USB keyboard simulation (with triggering support for up/down keys)
- Standard USB joystick simulation (6 axis, 32 buttons with triggering support)
- 55 digital inputs with pull-up resistors, freely mappable to virtual USB keyboard’s keys
- 55 software controlled digital outputs
- 7 analog inputs (12-bit) with adjustable low-pass filtering support
- Up to 26 encoder pair inputs (3 high-speed encoder inputs, 1 ultra high speed encoder input)
- Digital counters on specific digital input pins
- 3-axis 25 kHz or 8-axis 125 kHz highly customizable Pulse engine v2 with safety 5 kHz charge-
pump output
- Two 8x8 matrix LED display support
- Up to 64 256-character long keyboard macro sequences
- Up to 16x8 matrix keyboard with triggered keys/alternate function support
- Two 8x8 matrix LED display support
- Up to 6 high-speed fully configurable PWM outputs support (25MHz PWM timer)
- HD44780-based character LCD support (up to 4x20 characters)
- PoExtBus support for adding up to 10 external shift registers
- PoNET devices support (48-key CNC keyboard mapped to matrix keyboard)
- Support for Connection signal output
- Fail-safe support in case of communication interruption
10
www.poscope.com
- Support for up to 10 sensors on I
2
C bus, up to 10 sensors on 1-wire bus and up to 7 analog
sensors (PoKeys56) or up to 100 sensors on I2C, 1-wire buses (PoKeys57)
- Communication compatible with PoKeys55 on application layer (data packet structure)
- Intuitive and user-friendly software
- Third-party support via communication DLL library and extensive protocol specification
document that allows porting to other systems

2.3. PoKeys56E / PoKeys57E

- Ethernet 10/100 with DHCP client or fixed IP support
- TCP connection with device
- 55 digital inputs with pull-up resistors
- 55 software controlled digital outputs
- 7 analog inputs (12-bit) with adjustable low-pass filtering support
- Up to 26 encoder pair inputs (3 high-speed encoder inputs, 1 ultra high speed encoder input)
- 3-axis 25 kHz or 8-axis 125 kHz highly customizable Pulse engine v2 with safety 5 kHz charge-
pump output
- Digital counters on specific digital input pins
- Up to 16x8 matrix keyboard
- Two 8x8 matrix LED display support
- Up to 6 high-speed fully configurable PWM outputs support (25 MHz PWM timer)
- HD44780-based character LCD support (up to 4x20 characters)
- PoExtBus support for adding up to 10 external shift registers
- PoNET devices support (48-key CNC keyboard)
- Modbus TCP support (access to digital IO, analog inputs, encoders’ counters, digital counters
values, PWM outputs, LCD display, LED matrix display, PoExtBus devices, matrix keyboard status)
- Support for up to 10 sensors on I
sensors (PoKeys56) or up to 100 sensors on I2C, 1-wire buses (PoKeys57)
- Web interface with newly designed dashboard and I/O status display with multiple user
accounts
- Support for communication with devices on I
- Support for Connection signal output
- Fail-safe support in case of communication interruption
- Communication compatible with PoKeys55 on application layer (data packet structure)
- Intuitive and user-friendly software
- Third-party support via communication DLL library and extensive protocol specification
document that allows porting to other systems
2
C bus, up to 10 sensors on 1-wire bus and up to 7 analog
2
C and 1-wire buses
11
www.poscope.com
PoKeys55
PoKeys56U/57U
PoKeys56E/57E
Number of pins on the board
55
55
55
Digital inputs
55
55
55
Digital outputs
55
55
55
Analog inputs
5x 10-bit
7x 12-bit
7x 12-bit
Analog ouputs
1x 10-bit
0
0
Number of encoders (normal)
25
25
25
Number of fast encoders
3 3 3
Number of ultra fast encoders
0 1 1
Number of PWM outputs
6 (12 MHz clock)
6 (25 MHz clock)
6 (25 MHz clock)
Number of digital counters
0
24
24
Pulse engine
not suported
int. 3-axis 25 kHz
ext. 8-axis 125 kHz
int. 3-axis 25 kHz
ext. 8-axis 125 kHz
LCD support
Alphanumeric up to
4x20
Alphanumeric up to
4x20
Alphanumeric up to
4x20
Matrix keyboard support
Up to 16x8
Up to 16x8
Up to 16x8
Matrix LED
Two 8x8
Two 8x8
Two 8x8
Keyboard emulation
Yes
Yes
No
Joystick emulation
Yes
Yes
No
Connectivity
USB
USB
Ethernet (IPv4 +
DHCP)
Modbus TCP support
No
No
Yes
I2C sensors
No
Yes
Yes
1-wire sensors
No
Yes
Yes
PoExtBus support
up to 80 outputs
up to 80 outputs
up to 80 outputs
PoNET bus support
No
up to 16 devices
up to 16 devices
Power supply
powered from USB
powered from USB
external power
supply
Number of devices per computer
127 per USB root
hub
127 per USB root
hub
practically unlimited
Automatic device discovery
Yes
Yes
Yes (in local
network)
Free configuration application
Yes
Yes
Yes
Free firmware upgrades
Yes
Yes
Yes
Communication DLL support
Yes
Yes
Yes
Availability
Out of production
Available
Available

3. Device comparison

12
www.poscope.com

4. Device hardware description

13
www.poscope.com
Pin
Type
Description
1
I/O
General purpose digital input/output pin (limited current source capability on PoKeys56E/57E)
I
Fast encoder 1A A channel input for the fast encoder 1
I
Counter 1 – Counter input signal for counter 1 (not available on PoKeys55)
2
I/O
General purpose digital input/output pin (limited current source capability on PoKeys56E/57E)
I
Fast encoder 1B B channel input for the fast encoder 1
I
Counter 2 – Counter input signal for counter 2 (not available on PoKeys55)
3
I/O
General purpose digital input/output pin
4
I/O
General purpose digital input/output pin
5
I/O
General purpose digital input/output pin (when used as output on PoKeys56E/57E, pin 6 must also be specified as output)
I
Fast encoder 2A A channel input for the fast encoder 2
I
Counter 5 – Counter input signal for counter 5 (not available on PoKeys55)
6
I/O
General purpose digital input/output pin (when used as output on PoKeys56E/57E, pin 5 must also be specified as output)
I
Fast encoder 2B B channel input for the fast encoder 2
I
Counter 6 – Counter input signal for counter 6 (not available on PoKeys55)
7
I/O
General purpose digital input/output pin
8
I/O
General purpose digital input/output pin
I
Ultra fast encoder input A (not available on PoKeys55)
9
I/O
General purpose digital input/output pin
SF
PoKeys56E/57E: external pulse generator - see Pulse engine manual
O
Matrix LED 1 serial data output
I
Counter 9 – Counter input signal for counter 9 (not available on PoKeys55)
10
I/O
General purpose digital input/output pin
O
Matrix LED 1 output latch clock output
11
I/O
General purpose digital input/output pin
SF
PoKeys56E/57E: external pulse generator - see Pulse engine manual
O
Matrix LED 1 serial clock output
I
Counter 11 – Counter input signal for counter 11 (not available on PoKeys55)
12
I/O
General purpose digital input/output pin
I
Ultra fast encoder input B (not available on PoKeys55)
13
I/O
General purpose digital input/output pin
I
Ultra fast encoder index signal input (not available on PoKeys55)
14
I/O
General purpose digital input/output pin
15
I/O
General purpose digital input/output pin
I
Fast encoder 3A A channel input for the fast encoder 3
I
Counter 15 – Counter input signal for counter 15 (not available on PoKeys55)
16
I/O
General purpose digital input/output pin
I
Fast encoder 3B B channel input for the fast encoder 3
I
Counter 16 – Counter input signal for counter 16 (not available on PoKeys55)
17
I/O
General purpose digital input/output pin
O
PWM channel 6 output
I = input, O = output, I/O input or output, SF = special function
14
www.poscope.com
18
I/O
General purpose digital input/output pin
O
PWM channel 5 output
19
I/O
General purpose digital input/output pin
O
PWM channel 4 output
I
Counter 19 – Counter input signal for counter 19 (not available on PoKeys55)
20
I/O
General purpose digital input/output pin
O
PWM channel 3 output
I
Counter 20 – Counter input signal for counter 20 (not available on PoKeys55)
21
I/O
General purpose digital input/output pin
O
PWM channel 2 output
I
Counter 21 – Counter input signal for counter 21 (not available on PoKeys55)
22
I/O
General purpose digital input/output pin
O
PWM channel 1 output
I
Counter 22 – Counter input signal for counter 22 (not available on PoKeys55)
23
I/O
General purpose digital input/output pin
I/O
LCD data 7 (primary configuration)
O
Matrix LED 2 serial data output
SF
PoKeys56U: external pulse generator - see Pulse engine manual
I
Counter 23 – Counter input signal for counter 23 (not available on PoKeys55)
24
I/O
General purpose digital input/output pin
I/O
LCD data 6 (primary configuration)
O
Matrix LED 2 output latch clock output
I
Counter 24 – Counter input signal for counter 24 (not available on PoKeys55)
25
I/O
General purpose digital input/output pin
I/O
LCD data 5 (primary configuration)
O
Matrix LED 2 serial clock output
SF
PoKeys56U: external pulse generator - see Pulse engine manual
I
Counter 25 – Counter input signal for counter 25 (not available on PoKeys55)
26
I/O
General purpose digital input/output pin
I/O
LCD data 4 (primary configuration)
SF
PoKeys56U: external pulse generator - see Pulse engine manual
I
Counter 26 – Counter input signal for counter 26 (not available on PoKeys55)
27
I/O
General purpose digital input/output pin
I
Counter 27 – Counter input signal for counter 27 (not available on PoKeys55)
28
I/O
General purpose digital input/output pin
O
LCD R/W (primary and secondary configuration)
I
Counter 28 – Counter input signal for counter 28 (not available on PoKeys55)
29
I/O
General purpose digital input/output pin
O
LCD RS (primary and secondary configuration)
30
I/O
General purpose digital input/output pin
O
LCD E (primary and secondary configuration)
31
I/O
General purpose digital input/output pin
I/O
LCD data 7 (secondary configuration)
32
I/O
General purpose digital input/output pin
I/O
LCD data 6 (secondary configuration)
33
I/O
General purpose digital input/output pin
15
www.poscope.com
I/O
LCD data 5 (secondary configuration)
34
I/O
General purpose digital input/output pin
I/O
LCD data 4 (secondary configuration)
35
I/O
General purpose digital input/output pin
SF
External pulse generator dedicated IO connection - see Pulse engine manual
O
PoExtBus serial clock if PoExtBus on dedicated connector is not used
36
I/O
General purpose digital input/output pin
SF
External pulse generator dedicated IO connection - see Pulse engine manual
O
PoExtBus serial data if PoExtBus on dedicated connector is not used
37
I/O
General purpose digital input/output pin
SF
External pulse generator dedicated IO connection - see Pulse engine manual
O
PoExtBus output latch clock if PoExtBus on dedicated connector is not used
38
I/O
General purpose digital input/output pin
SF
External pulse generator dedicated IO connection - see Pulse engine manual
O
Pulse engine DIR x - x-axis direction output (not available on PoKeys55)
39
I/O
General purpose digital input/output pin
O
Pulse engine DIR y - y-axis direction output (not available on PoKeys55)
40
I/O
General purpose digital input/output pin
O
Pulse engine DIR z - z-axis direction output (not available on PoKeys55)
41
I/O
General purpose digital input/output pin
I
Analog input 41 (not available on PoKeys55)
I
Counter 41 – Counter input signal for counter 41 (not available on PoKeys55)
42
I/O
General purpose digital input/output pin
I
Analog input 42 (not available on PoKeys55)
I
Counter 42 – Counter input signal for counter 42 (not available on PoKeys55)
43
I/O
General purpose digital input/output pin
I
Analog input 43
I
Counter 43 – Counter input signal for counter 43 (not available on PoKeys55)
44
I/O
General purpose digital input/output pin
I
Analog input 44
I
Counter 44 – Counter input signal for counter 44 (not available on PoKeys55)
45
I/O
General purpose digital input/output pin
I
Analog input 45
46
I/O
General purpose digital input/output pin
I
Analog input 46
I
Counter 46 Counter input signal for counter 46 (not available on PoKeys55)
O
Integrated Pulse engine STEP x - x-axis step output (not available on PoKeys55)
47
I/O
General purpose digital input/output pin
I
Analog input 47
O
Connection signal output
48
I/O
General purpose digital input/output pin (limited current source capability on PoKeys56U)
I
Counter 48 Counter input signal for counter 48 (not available on PoKeys55)
O
Integrated Pulse engine STEP y - y-axis step output (requires additional 470 Ohm pull-up resistor on PoKeys56U) (not available on PoKeys55)
O
Connection signal output
16
www.poscope.com
49
I/O
General purpose digital input/output pin (limited current source capability on PoKeys56U)
I
Counter 49 Counter input signal for counter 49 (not available on PoKeys55)
O
Integrated Pulse engine STEP z - z-axis step output (requires additional 470 Ohm pull-up resistor on PoKeys56U) (not available on PoKeys55)
O
Connection signal output
50
I/O
General purpose digital input/output pin
O
Connection signal output
51
I/O
General purpose digital input/output pin
SF
PoKeys56E/57E: external pulse generator - see Pulse engine manual
O
Connection signal output
52
I/O
General purpose digital input/output pin
I
Pulse engine EMGERGENCY - emergency switch input (not available on PoKeys55)
O
Connection signal output
53
I/O
General purpose digital input/output pin
O
Pulse engine CHARGEPUMP - 5 kHz charge pump signal output (not available on PoKeys55)
O
Connection signal output
54
I/O
General purpose digital input/output pin
I
Recovery mode (RST) signal - PoKeys enters recovery mode if this signal is tied to GND at startup
O
Connection signal output
55
I/O
General purpose digital input/output pin
I/O
1-wire communication bus (not available on PoKeys55)
O
Connection signal output
Pin 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
DI DO AI AO Fast encoders Ultra fast encoders LCD LED Auxil ary output PWM Connection signal Configuration rese t Counters Special functions 1-wire
not supported supported

4.1. PoKeys56U/E pin functions graphical overview

4.2. PoKeys55 pin functions graphical overview (serial numbers above 11500)

17
www.poscope.com

4.3. Status LEDs

Each PoKeys devices has the following status LEDs:
- Red LED – power status: when the power is applied to PoKeys device, this LED is lit
- Green LED – connection/communication status: this LED reflects various operating modes of
the PoKeys device
o Fast blinking on startup: device has started in the recovery mode. This enables to
update the firmware and clear the settings in the device.
o Slow blinking on startup (PoKeys56E/57E): PoKeys device is waiting for DHCP settings o Solid: device is in normal operation mode
18
www.poscope.com

5. Requirements

5.1. USB devices

- One available USB 1.1 or USB 2.0 port
- USB HID device driver enabled operating system (Windows 98
SE/ME/2000/XP/Vista/Windows 7/8/10, Linux, Mac OS)
- Included software requires Windows XP/Vista/Windows 7/Windows 8/Windows 10 with
.NET frameworks 2.0 and 3.5 installed (ONLY FOR SYSTEMS WHERE THE DEVICES WILL BE CONFIGURED, TARGET SYSTEM NEEDS NO SOFTWARE INSTALLATION FOR THE DEVICE TO OPERATE AS A STANDARD USB KEYBOARD AND JOYSTICK).

5.2. Network devices

PoKeys57E v1.2

- Ethernet connection between host computer and PoKeys57E device
- 5-12 V DC power supply with 400 mA current capability. If any additional peripheral is
connected to PoKeys57E, use appropriately more powerful power supply.
- Included software requires Windows XP/Vista/Windows 7/Windows 8/Windows 10 with
.NET frameworks 2.0 and 3.5 installed (ONLY FOR SYSTEMS WHERE THE DEVICES WILL BE CONFIGURED, TARGET SYSTEM NEEDS NO SOFTWARE INSTALLATION FOR THE DEVICE TO OPERATE AS A STANDARD NETWORK DEVICE).

PoKeys56E/PoKeys57E v1.1

- Ethernet connection between host computer and PoKeys56E device
- 5V DC power supply with 400 mA. If any additional peripheral is connected to PoKeys56E,
use appropriately more powerful power supply.
- Included software requires Windows XP/Vista/Windows 7/Windows 8/Windows 10 with
.NET frameworks 2.0 and 3.5 installed (ONLY FOR SYSTEMS WHERE THE DEVICES WILL BE CONFIGURED, TARGET SYSTEM NEEDS NO SOFTWARE INSTALLATION FOR THE DEVICE TO OPERATE AS A STANDARD NETWORK DEVICE).
19
www.poscope.com

6. Technical specifications

6.1. PoKeys55, PoKeys56U and PoKeys57U dimensions

Measurements are in mm, all holes have 3mm diameter.
20
www.poscope.com

6.2. PoKeys56E/57E dimensions

Measurements are in mm, all holes have 3mm diameter.
21
www.poscope.com
Symbol
Parameter
Min
Max
Unit V
IA
analog input voltage on ADC related pins
-0.5
3.6
V
VI Input voltage on other pins
-0.5
5.5
V
V
esd
electrostatic discharge
-4000
4000
V
Symbol
Parameter
Conditions
Min
Typ
Max
Unit VI input voltage
pin configured as digital input
0 - 5.5 V VO output voltage
pin configured as digital output
0 - 3.3 V V
IH
HIGH-level input voltage
2.0 - - V V
I_analog
analog input voltage
pin configured as analog input
0 - 3.3
V
V
O_analog
analog output voltage
pin configured as analog output
0 - 3.3
V
V
IL
LOW-level input voltage
- - 0.8 V V
hys
hysteresis voltage
0.4 - - V V
OH
HIGH-level output voltage
IOH = -4 mA
2.9 - - V V
OL
LOW-level output voltage
IOH = 4 mA
- - 0.4 V I
OH
HIGH-level output current
VOH = 2.9 V
-4 - -
mA
I
OL
LOW-level output current
VOL = 0.4 V
4
- - mA
I
OHS
HIGH-level short-circuit output current
V
OH
= 0 V
- - -45
mA
I
OLS
LOW-level short-circuit output current
VOL = 3.3V
- - 50
mA
I
pu
pull-up current
0 (V
I
>= 3.3V)
-50
-100
µA
I
5V
5V pin source current
400
mA
I5V
Power supply current for PoKeys57E v1.2 without peripherals
Uin = 5 V Uin = 12 V
100 50
120 60
150 75
mA mA
I5V
5V power supply current for PoKeys56E and PoKeys57E v1.1 without peripherals
250
300
400
mA
I
3.3V
Maximum current of 3.3V power supply for external devices
- -
120
mA
V
BATT
Lithium battery for RTC functionality (CR1220)
- 3 - V
Parameter
Min
Typ
Max
Unit
Power supply range
- PoKeys56U, *56E, *57U
- PoKeys57E v1.2
4.5
4.5
-
-
5.5 15
V V
Operating temperature
0 - 60
°C
Storage temperature
-40 - 85
°C
Humidity
5 - 95 (non-condensing)
% RH

6.3. Electrical specification – limiting values

6.4. Electrical specification – static characteristic

6.5. Environment specifications

22
www.poscope.com

6.6. Power supply for PoKeys57E v1.2

PoKeys57E requires external 5-12 V power supply to be connected to the board. PoKeys57E uses switching power supply to power the 5 V power supply bus (also available on pin +5V for external peripherals that require +5V). If any additional peripheral is connected to PoKeys57E board, combined current of peripheral and PoKeys57E board must be taken into consideration when selecting the power supply.
Take care when selecting proper power supply for PoKeys57E. The power supply may never exceed the voltage of +15 V or the PoKeys57E can get damaged.

6.7. Power supply for PoKeys56E (and PoKeys57E v1.1)

PoKeys56E requires external 5V power supply to be connected to the board. If any additional peripheral is connected to PoKeys56E board, combined current of peripheral and PoKeys56E board must be taken into consideration when selecting the power supply.
Due to the protection diode in the circuit, a 0.8 V voltage drop can be observed between input voltage and 5V pin. When supplying the PoKeys56E board with 5V power supply, take care when connecting peripherals that require 5V supply voltage (e.g., LCD displays).
23
www.poscope.com

7. Installation

PoKeys55 and PoKeys56U are USB 1.1/2.0 compliant devices and as such require no additional drivers for operation as a standard USB keyboard and joystick.
PoKeys56E/57E is an Ethernet device that requires an Ethernet connection between host computer and the device and the external power supply. No additional drivers are required. Network firewalls must allow all traffic on TCP/UDP port 20055.
To operate the device after the device has been configured there is no software installation necessary on a target system.
To configure the device the supplied software must be installed and the requirements listed in previous section of this manual must be met.
24
www.poscope.com
1

8. PoKeys configuration options

8.1. Digital inputs and outputs

Any of the 55 pins, available on the terminals on the PoKeys PCB, can be configured as digital input or output with selectable polarity. All pins have a weak pull-up resistor enabled and are 5V tollerant.
At every startup, all digital input or output configured pins are preset as digital input pins (with the weak pull-up resistor pulling the state of the pin to logical 1). To enable output function on a selected pin, SetPinFunction command must be executed. This behaviour can be disabled using the SetAutoSetOutputs command or via PoKeys configuration software (Settings > Initialize outputs on startup). Each output pin can sink or source up to 4 mA of current, with the limitation that the pins combined source or sink current does not exceed 100 mA.
All digital input pins on PoKeys55 or PoKeys56U can be configured to simulate a configurable USB keyboard key. When there is a high state on pin (on low state when using inverted polarity option) PoKeys device sends a USB message with the key code and modifier associated with this pin. Moreover, PoKeys device can simulate a series of key presses, what is called a macro sequence. Up to 64 different macro sequences can be setup with the combined total length of 3584 characters with each macro sequence shorter than 128 keys. All macros can be labelled with a 7-character name. Character codes (most frequently used are listed in the Appendix to this document) are USB HID standard keyboard codes.
An extension to the USB keyboard mapping described above, PoKeys supports also triggered mapping of inputs to USB keyboard keys. In triggered mapping mode, only pin state transitions (low­to-high or high-to-low trigger a USB key press) with different key combinations for each transition.
Type-matic like repeat and delay is an additional extension to the triggered key mapping. Instead of relying on the user’s system to trigger key repeat events, PoKeys can be configured to simulate repeated key presses at the predefined rate (period between two key presses is adjustable in 5 ms cycles – 0.78 to 200 repeats possible1) after a predefined delay (adjustable in steps of 5 ms – 0 to 1275 ms possible).

PoKeys configuration software usage

There is graphical representation for configuration of each PoKeys device’s pin on left and right side of main window. To change pin function, click on pin name and change its function in central ‘Pin settings’ frame.
The maximum repeat rate depends on the user's system
25
www.poscope.com
Figure 1: PoKeys configuration window
There are 6 main pin functions possible: inactive, digital input, triggered digital input, digital output, analog input and analog output.
Inactive
Any pin (except those fixly mapped to an activated peripheral) can be set as inactive. Inactive pin is put in high-Z state with internal pull-up resistors enabled.
Digital input
Any one of the 55 pins can be configured as digital input by selecting ‘Digital input’ option box. If the
pin polarity is wished to be inverted, check the 'Invert pin' box.
There are several additional possibilities for digital input pin functions.
Direct key mapping – only for USB devices
Digital input set up for direct key mapping acts like a keyboard key. When there is a high state on pin (on low state when using inverted option), PoKeys55/PoKeys56U sends a key associated with this pin. Select a keyboard key from drop-down box and check appropriate key modifiers (Shift, Ctrl, …).
Example: Send Alt-F4
Select F4 from drop-down box and check Alt checkbox.
Example: Send ( (opening bracket)
This key kombination differs from your system regional settings. As the PoKeys55/PoKeys56U devices emulate a system keyboard, key associations depend on current sytem keyboard regional setting. To send an opening bracket symbol, one possible solution is to press Shift-8 (in most non-English countries) or to press Shift-9. Out of this reason there are no such secondary keys listed in drop­down box and must be entered by user as described above.
26
www.poscope.com
1 2 3
4
Example: starting a program on Windows using PoKeys55/PoKeys56U device
On a Windows operating system, users can assign a custom shortcut key to any program shortcut. Find the shortcut and then right click on it to show the context menu (Step 1). Select Properties (Step
2), and under the Shortcut tab (Step 3), click on the ‘Shortcut key’ text box. Proceed by typing in a
combination that you wish to assign to a particular program (Step 4). Next, open the PoKeys application and connect to the desired PoKeys device. Click on the pin that will function as a launch trigger for your application (Step 5). Under Key mapping, select the same keyboard combination that you assigned to the program shortcut (Step 6). Click on the ‘Send to device’ button (Step 7) to transfer settings to the device. This will activate the new shortcut.
27
www.poscope.com
5
6
7
Figure 2: Setting up PoKeys device
Keyboard macro – only for USB devices
PoKeys55 and PoKeys56U devices support keyboard macros – the key press combinations that can be up to 256 keys long. To define a keyboard macro, first select Keyboard macro mapping option for one
of the pins. ‘Edit macros’ and ‘Get names’ command buttons become enabled. To add, change or delete macros click the ‘Edit macros’ button. The following dialog appears
28
www.poscope.com
Figure 3: Macro editing dialog
First select the macro you want to edit. To change macro name, enter desired macro name (up to 7 characters long) in 'Macro name' text box and click 'Change' button. This name is used only to help user differentiate between multiple macros.
To set macro contents, simply enter text into 'Macro contents' text box. If there is an invalid character found, the text appears red. When finished, click Write to write macro to device.
List box at the right displays final macro sequence that is sent to PC when the macro gets activated.
Triggered digital input – only for USB devices
Any one of the 55 pins can be configured as triggered digital input by selecting ‘Triggered input’
option box. This pin mode enables user to select a key that is pressed only when a transition in a signal occurs. Different keys can be selected for ‘LOW-to-HIGH’ or ‘Key up’ event and for ‘HIGH-to­LOW’ or ‘Key down’ event. Selecting the keys is similar to Direct key mapping described above.
Digital output
Any one of the 55 pins can be configured as digital output by selecting ‘Digital output’ option box. If the polarity of the pin is wished to be inverted, check the 'Invert pin' box. On startup, all pins (although optionally configured as digital output) are by default initialized in high-Z state (behaving like inputs). To use the outputs, SetPinData should be called before attempting to set the output state. However, there is an option to disable this behaviour - use the ‘Settings > Initialize outputs on startup’ option to either enable or disable output activation on PoKeys startup.
View status of digital inputs and outputs
Go to ‘Peripherals > Digital inputs and outputs…’ to display the status dialog as shown below.
29
www.poscope.com
Read or set single pin state
GetInput SetOutput
Reads current state of digital input Sets digital output state
Read or set single pin function
GetPinData SetPinData
Reads pin function Set pin function
Read or set single pin key or macro mapping
GetPinKeyMapping SetPinKeyMapping
Reads pin key mapping Sets pin key mapping options
GetPinMacroMapping SetPinMacroMapping
Reads pin macro mapping Set pin macro mappping options
Read or set triggered input mapping
GetTriggeredInputMapping SetTriggeredInputMapping
Reads triggered input mapping options Sets triggered input mapping options
Read or set type-matic like delays and rates
GetTypeMaticDelaysAndRates SetTypeMaticDelaysAndRates
Gets the typematic delay and repeat rate Sets the typematic delay and repeat rate
Figure 4: Input and output status dialog
There are 55 pins represented as colored squares in the dialog, organized in the rows of 8 pins. Each square contains a pin index number in the lower left corner, while the lower right corner is used to indicate a digital output (small black triangle is displayed on pins, configured as digital outputs). The color of the square resembles the current state of the pin – green for the activated (HIGH state) and white for the unactivated (LOW state).
To change the digital output state, first enable ‘Enable output control’ option, then either left or right click with mouse on the square representing the digital output to activate or deactivate this output.

Applicable PoKeys library commands

30
www.poscope.com
Read or write multiple inputs and outputs
BlockGetInput1 / BlockGetInput2 / BlockGetInputAll55 BlockSetOutput1/BlockSetOutput2/ BlockSetOutputAll55
Read block of inputs (1 to 32) / (33 to 55) / (1 to 55) Set block of outputs (1 to 32) / (33 to 55) / (1 to 55)
Read or set multiple pin configurations
GetAllPinConfiguration GetAllPinKeyCodes GetAllPinKeyMapping GetAllPinKeyModifierss SetAllPinConfiguration SetAllPinKeyCodes SetAllPinKeyMapping SetAllPinKeyModifierss
Read pin configuration for all pins Read pin key codes for all pins Read pin key mapping for all pins Read pin key modifiers for all pins Set pin configuration for all pins Set pin key codes for all pins Set pin key mapping for all pins Set pin key modifiers for all pins
Read or set automatic output initalization option
GetAutoSetOutputs SetAutoSetOutputs
Get automatic outputs initialization option Set automatic outputs initialization option
Macro-related commands
GetMacroKeys GetMacroName MacroCreate MacroDelete MacroGetActiveMacros MacroGetFreeSpace MacroGetLength MacroModifyLength MacroSaveConfiguration SetMacroKeys SetMacroName
Read key mapping for a macro Read macro name Reserve the space for a new macro Delete a specific macro Read the macro activation status Get free space for macros Read macro length Modify the length of a macro Save configuration of macros Set key mapping for a macro Set macro name
COM_Execute command
COM_ExecuteInner with the following parameters:
- GetDigitalPinValues
- SetDigitalPinValues
- GetPinConfiguration
- SetPinConfiguration
Read digital inputs Set digital outputs Read pins configuration Set pins configuration
Raw basic device report
GetFullDeviceReport
Set and read full device report

8.2. Connection signal output

Connection signal pin status can be set for pins 48 to 55. When USB connection with PC is established (or ethernet link is established on PoKeys56E/57E), pin for which 'Connection signal pin status' is enabled, will be put into high state (or low state if pin polarity is setup as inverted). If the connection
Loading...
+ 98 hidden pages