PoKeys57CNC User’s manual Version: 17/2/2020
PoKeys user manual Please read the following notes 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 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.
PoKeys user manual Contents 1. Introduction ..................................................................................................................................... 7 2. Features ........................................................................................................................................... 8 3. Device hardware description........................................................................................................... 9 3.1.
PoKeys user manual 7. 6.1. Using USB .............................................................................................................................. 24 6.2. Using Ethernet - direct connection between PoKeys57CNC and computer ......................... 24 6.3. Using Ethernet - PoKeys57CNC connected to a network with DHCP server ......................... 25 6.1. Using USB and Ethernet .......................................................................................................
PoKeys user manual Adding new devices ....................................................................................................................... 51 PoNET kb48CNC keyboard............................................................................................................. 52 7.12. Failsafe settings ................................................................................................................. 53 7.13. Peripheral communication protocols ...............................
PoKeys user manual 6 www.poscope.
PoKeys user manual 1. Introduction 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. PoKeys57CNC features both USB and Ethernet connectivity, giving user an option to select the preferred connection for the application. The device is highly adjustable and as such requires no complex knowledge on device programming. PoKeys57CNC is a blend between general purpose PoKeys device and motor controller.
PoKeys user manual 2. Features - Compatible with USB 1.1/2.
PoKeys user manual 3. Device hardware description - PoKeys57CNC v1.2 (and later) 1 2 9 www.poscope.
PoKeys user manual Devices prior to PoKeys57CNC v1.2 (different 26-pin ‘Test IO’ connector pinut): 10 www.poscope.
PoKeys user manual 3.1. PoKeys57CNC connector pinout Pin types Type code DI5P DI33P DO5 DO5_D DIO33 OCOC OCSSR REL AN33 AN33F Description 5 V digital input with input filtering 3,3 V digital input with input filtering 5 V digital output 5 V digital output without series resistor 3,3 V digital input or output without filtering Opto-coupled open-collector output Open-collector outputs for SSR Relay output 3,3 V analog input without filtering 3,3 V analog input with 1,9 kHz low-pass filtering See chapter 3.
PoKeys user manual SSR (Solid State Relay) connector Pin Type Function 1 OCSSR SSR2 output 2 +5V +5V output (power supply to SSR relay) 3 OCSSR SSR1 output The solid state relays should be connected between +5V output and corresponding SSR output pin. Note: all +5V output pins on the board share the same power supply and the current is distributed to all loads.
PoKeys user manual 7 8 9 10 11 12 13 14 15 16 DIO33 DIO33 DIO33 DIO33 +5V OC D4 D5 D6 D7 LED+ LED- Pendant connector Pin Type Label 1 +5V +5V 2 GND GND 3 GND GND 4 DI33P E-stop 5 6 7 8 9 10 11 DIO33 GND-E DIO33 GND +5V DI33P OC FastEncA E-Stop FastEncB GND LED+ Ax-B LED- 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 DI33P DI33P DI33P DI33P GND DI33P GND DI33P GND DI33P GND DI33P GND Ax-C Ax-X Ax-Y Ax-Z GND Ax-A GND Step x1 GND Step x10 GND Step x100 GND not connected not connected not connected not
PoKeys user manual a) E-stop switch is connected to dedicated 4-pin E-stop connector between pins 2 and 3. Jumper 'NeST' must be removed and inserted into the pendant connector between pins 4 and 6 b) E-stop switch is connected to pendant connector (between pins 4 and 6). Jumper 'NeST' must be present c) Two E-stop switches are connected - one to dedicated 4-pin E-stop connector (betwen pins 2 and 3) and one to pendant connector (between pins 4 and 6). 14 www.poscope.
PoKeys user manual Encoders connector Pin Type Label 1 +5V +5V 2 GND GND 3 DIO33 uFEA 4 GND GND 5 DIO33 uFEB 6 GND GND 7 DIO33 uFEI 8 GND GND 9 DIO33 PK20 10 GND GND ADC connector Pin Type 1 GND 2 GND 3 AN33F 4 AN33F 5 +3,3V 6 +3,3V 7 AN33F 8 AN33F 9 AN33/DIO33 10 GND 3 Function Axis enable signal (inverted) Ground Ultra-fast encoder A-channel signal input, also used as PoKeys pin 8 Ground Ultra-fast encoder B-channel signal input, also used as PoKeys pin 12 Ground Ultra-fast encoder index signal input, a
PoKeys user manual Motor connectors 1-8 Pin Type Label 1 DO5 /AXEn 2 GND GND 3 DO5 DIR 4 GND GND 5 DO5 STEP 6 GND GND 7 DI5P /ERRORin 8 GND GND 9 +5V 5V 10 GND GND Function Axis enable signal (inverted) Ground Direction signal Ground Step signal Ground Error input signal (from stepper driver to PoKeys) Ground +5V output to stepper driver Ground Axis switches connector Pin Type Label 1 GND GND 2 GND GND 3 DI5P AX84 DI5P AX8 H 5 DI5P AX76 DI5P AX7 H 7 DI5P AX68 DI5P AX6 H 9 DI5P AX510 DI5P AX5 H 11 DI5P AX4
PoKeys user manual 9 10 11 12 DI5P GND GND DI5P AX8+ GND GND Probe Axis 8 limit+ switch Ground Ground Probe input On PoKeys57CNC v1.0, v1.1 and v1.2 external pull-up resistor must be used DB-25 (LPT-port) IO connector Warning: on PoKeys57CNC v1.1 the pinout is not compatible with the LPT-based stepper drivers since the physical pin numbering sequence in PoKeys57CNC v1.1 differs from that of a real DB-25 connector. Check the pinout diagrams above. The connector on the PoKeys57CNC v1.
PoKeys user manual 3.2.
PoKeys user manual Type DIO33: 3,3 V digital input or output Digital pin directly connected to MCU. Symbol Parameter Ipu pull-up current Pin used as digital output IDO33,MAX maximum current supplied by DO33 pin VDO33,LOW voltage of LOW state (no current) VDO33,HIGH voltage of HIGH state (no current) Pin used as digital input VDI5,MAX maximum voltage applied to DI5 pin VDI5,LOW applied voltage for LOW state VDI5,HIGH applied voltage for HIGH state Min Max Unit 0 (V >= 3.
PoKeys user manual Type OCSSR: open-collector output for SSR (Solid State Relay) Symbol Parameter Min Max Unit IOCSSR,MAX UOCSSR,MAX maximum current sunk by OCSSR pin maximum voltage applied to OCSSR pin - 500 5 mA V Type REL: relay output Symbol Parameter Min Max Unit IREL,28VDC IREL,125VAC IREL,240VAC maximum current switching at 28 VDC maximum current switching at 125 VAC maximum current switching at 240 VAC - 10 10 7 A A A Type AN33: 3.
PoKeys user manual Type AN33F: 3.3 V analog input with low-pass filter Symbol Parameter Min Max Unit VIA fLP -0.5 1.6 3.3 2.2 V kHz analog input voltage on ADC related pins cut-off frequency of the analog low-pass filter 3.3. Status LEDs o 21 TBD www.poscope.
PoKeys user manual 4. Requirements - 6-26 V power supply with 2.5 W or more, one available USB 1.1 or USB 2.0 port, Ethernet connection between host computer and PoKeys57CNC device, USB HID device driver enabled operating system (Windows 98 SE/ME/2000/XP/Vista, Linux, Mac OS), included software requires Windows XP/Vista/7/8/8.1/10 with .NET framework 3.5 installed. 22 www.poscope.
PoKeys user manual 5. Technical specifications 5.1. PoKeys57CNC dimensions Measurements are in mm. 5.2. Environment specifications Parameter Min Typ Max Unit Power supply range Operating temperature Storage temperature Humidity 6 0 -40 5 - 26 60 85 95 (non-condensing) V °C °C % RH 23 www.poscope.
PoKeys user manual 6. Installation 6.1. Using USB PoKeys57CNC is a USB 1.1/2.0 compliant device. Step 1: Locate a free USB 2.0 port on your computer (1) and PoKeys57CNC board (2) and connect them with a standard USB cable. Step 2: Connect the PoKeys57CNC board to an appropriate power supply (3). Step 3: Install PoKeys software Step 4: Open PoKeys application, connect to your PoKeys57CNC device and enable Fast USB interface (go to Settings > Enable Fast USB interface).
PoKeys user manual 6.3. Using Ethernet - PoKeys57CNC connected to a network with DHCP server Network firewalls must allow all traffic on TCP/UDP port 20055 between PoKeys57CNC device and PoKeys-related software running on a computer. Step 1: Locate ethernet ports on your router (1) and PoKeys57CNC board (2) and connect them with RJ-45 cable (standard network cable). Step 2: Connect the PoKeys57CNC board to an appropriate power supply (3). Step 3: Install PoKeys software 6.1.
PoKeys user manual 7. PoKeys configuration options 7.1. Digital inputs and outputs Unlike generic PoKeys devices, PoKeys57CNC doesn’t have generic pin headers with fully customizable pin functions. Certain pins of the dedicated connectors on PoKeys57CNC can be reused for other purposes if not used by the specific peripheral device. See the connector pinout diagram to discover which pins can be reused as digital inputs or digital outputs.
PoKeys user manual There are 6 main pin functions possible: inactive, digital input, triggered digital input, digital output, analog input, depending on the capabilities of each pin. 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 free pin can be configured as digital input by selecting ‘Digital input’ option box.
PoKeys user manual 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).
PoKeys user manual 7.3. Encoders PoKeys devices can handle decoding of up to 26 pairs of quadrature encoder signals. A and B signals of 25 'normal' encoders can be connected to any digital input and are intended for hand-driven rotational encoder switches with the quadrature signal frequencies up to 1 kHz.
PoKeys user manual PoKeys configuration software usage To enable encoder input on the selected pin, define the pin as digital input, switch to ‘Encoders/Counters’ tab, select encoder index with numerical up-down selector and select appropriate encoder channel. The last step is to check the box ‘Encoder’. To assign a key combination associated with the encoder, use the same procedure as described in the ‘Digital inputs and outputs’ section.
PoKeys user manual Figure 4: Encoders' RAW values 31 www.poscope.
PoKeys user manual 7.4. Pulse engine PoKeys57CNC is a hybrid device between a USB PoKeys, Ethernet PoKeys nad PoKeysCNCaddon. As such, it contains an external pulse generator on-board, which is capable of driving of up to 8 axes controlled by STEP/DIR signals with maximum pulse frequency of 125 kHz.
PoKeys user manual Pulse engine status/control dialog parts 1. Main Pulse engine settings: a. Enable pulse engine: main switch to enable or disable Pulse engine functionality b. Lock: when Lock is enabled, the main Pulse engine settings and Pulse generator settings are disabled c. Enable safety charge pump output: configure the pin for the charge pump output d.
PoKeys user manual a. Relays 0 and 1 control the SSR outputs b. Relays 2 and 3 control the on-board relays c. OC-outputs control the galvanically isolated open-collector outputs Axis configuration panel This panel contains settings for each axis. Figure 6: Axis configuration panel 1. Limit switch configuration: individual limit switch (on axis positive and negative ends) can be individually enabled and inverted (in NO switches are used).
PoKeys user manual into the fields, confirm the value by pressing ‘Enter’ (‘Return’) key - the field will change color from red to white. 9. Soft limits configuration: optionally, soft limits can be configured for each axis. When internal motion controller detects the current position has gone out of these limits, the motion is softly stopped and only motion in the out-of-limit direction is allowed. 10. Backlash compensation: PoKeys devices support backlash compensation feature.
PoKeys user manual Common homing algorithm configurations Although the homing algorithm is configurable, there are some standard configurations that fit most CNC machine configurations: 1. Standard homing configuration 2. Homing without reverse 3. Homing with encoder index - standard 4. Homing with encoder index - without reverse 36 www.poscope.
PoKeys user manual Limit and home switch filters The limit and home switch inputs support digital filtering. The filter value defines the minimum time for the limit or home switch signal activation (1 unit equals to 100 µs = 0.0001 s) - possible values are between 0 (no filtering) to 254 (25.4 ms).
PoKeys user manual Automatic refresh of PoStep status can be enabled by configuring the auto-refresh options. Select the values to refresh and click on 'Configure'. PoKeys will periodically scan through PoStep devices and retrieve their statuses. Connecting configuration bus of PoStep drivers to PoKeys57CNC Connect PoStep drivers (PoStep60-256) in parallel with PoKeys57CNC device using PoExtension2 bus.
PoKeys user manual Figure 12: I2C address configuration in PoStep configuration tool 39 www.poscope.
PoKeys user manual 7.5. Matrix keyboard Matrix keyboard is a set of buttons, connected into a mesh. All buttons in a row share one contact, same goes for each of the buttons in the column. If a button is pressed, a key press is detected with a periodic scanning of each of the rows and columns. PoKeys devices use digital outputs for setting the voltage levels on rows and read column voltage levels using digital inputs that already have internal pull-up resistors, so no external circuitry is needed.
PoKeys user manual Figure 15: Assigning row and column pins Matrix keyboard column selection Each free digital input pin can be assigned as matrix keyboard column input. Make sure the selected pin is configured as digital input, then check the ‘Matrix keyboard’ option for the pin and select the appropriate column letter from the list. Matrix keyboard row selection Each free digital output pin can be assigned as matrix keyboard row output.
PoKeys user manual Figure 16: Matrix keyboard configuration for a 4x3 matrix keyboard 7.6. Analog inputs Analog input function is only available on pins 41 to 45. These analog inputs can also be freely mapped to any of the 6 joystick axis; X, Y, Z, rotation X, rotation Y and throttle.
PoKeys user manual be flickering or jumping due to analog signal noise, move the value for the filter to the right towards label ‘slow signals’ and then press Set button. Figure 17: Analog inputs and outputs dialog 7.7. Joystick mapping Each axis of the PoKeys virtual joystick can be assigned an analog input source. In addition, analog to digital mapping option can be enabled, which allows user to connect an analog joystick to a PoKeys devices and simulate key presses for each direction of the joystick.
PoKeys user manual For simple direct mapping (pin input status is directly reflected in joystick button status) use the ‘Direct mapping’ option and select pin number to be associated with selected joystick button.
PoKeys user manual increased current demand - pins with such function embedded are marked as OC (open-collector) in the pinout diagram. PoKeys PWM outputs can also be used to drive various R/C servo motors that accept PWM signal with 50 Hz frequency (20 ms PWM period) and duty cycles between 5 and 10 % (1 to 2 ms). PoKeys devices have an in-built PWM module that operates at a fixed clock frequency (25 MHz). Both the PWM period and the PWM duty cycles must be expressed as number of module clock cycles (i.e.
PoKeys user manual 7.9. LCD PoKeys devices support connecting one alphanumeric LCD module up to a size of 4x20 (4 rows, 20 columns). The selection of the module is limited by support for HD44780 or compatible chipset. Usually these displays come in various sizes - 1/2/4 line with 8/16/20 characters and colors (black letters on green background, white letters on blue background ...).
PoKeys user manual Figure 22: Character LCD testing dialog LCD settings In this part, user can set number of rows and columns in the LCD used. Support for LCD can be enabled or disabled also. LCD operations Before user can start using the LCD, LCD module must be initialized. This is done via 'Initialize LCD' button. Button 'Clear LCD' clears LCD display and moves cursor to home position. LCD module is initialized automatically by PoKeys device on device startup if ‘Enable LCD support’ option is enabled.
PoKeys user manual LCD custom character editor Produced code unsigned char uCustomChar[8] = { 0x10, 0x1C, 0x04, 0x04, 0x04, 0x04, 0x07, 0x01, }; Move cursor This section enabled user to move cursor to any position on the screen works only in ‘unbuffered’ mode described above. Print text Sends entered text to display module. If advanced characters are needed, enter character code in lower text box and press 'Print character'. 48 www.poscope.
PoKeys user manual 7.10. PoExtBus PoExtBus bus support enables user to add additional ten 8-bit shift registers to add up to 80 additional digital outputs to PoKeys device. Figure 23: PoExtBus outputs chaining PoKeys configuration software usage To set-up and test PoExtBus, open 'Peripherals' > PoExtBus...'. The dialog below (Figure 24) appears. By using mouse left and right clicks, user can turn on or off each of the outputs.
PoKeys user manual 7.11. PoNET PoKeys57CNC device supports PoNET devices (such as kb48CNC CNC keyboard). Multiple PoNET and PoExtBus devices can be linked together. While the PoNET devices and PoExtBus devices share the same PoExtBus/PoNET connector, user should pay attention in connecting devices of both types together (see the schematics below).
PoKeys user manual Adding new devices After connecting new PoNET device, go to ‘Peripherals > PoNET...’. The following dialog will appear Figure 25: PoNET settings dialog with an unconfigured device In order to register new device, double click on the 'Unconfigured device' icon. In the next 10 seconds press any key on the device that is about to be added. If the process is successful, status LED on the device will stop blinking and will be constantly lit.
PoKeys user manual PoNET kb48CNC keyboard The device can be virually mapped to PoKeys matrix keyboard. Third party software can set the status of LEDs under the keys, read the light sensor that measure the amount of light in the environment and set the intensity of the LEDs. To map the PoNET keyboard to PoKeys matrix keyboard, initialize the PoNET bus as described above in 'Adding new devices', select the keyboard in the device list and check the checkbox 'Enable mapping to matrix keyboard'. 52 www.
PoKeys user manual 7.12. Failsafe settings PoKeys devices support the configuration of the failsafe state for the digital outputs, PWM outputs, PoExtBus devices and PoKeys Pulse engine.
PoKeys user manual 7.13. Peripheral communication protocols I2C protocol The I2C bus was designed by Philips in the early '80s to allow easy communication between components which reside on the same circuit board. Philips Semiconductors migrated to NXP in 2006. The name I2C translates into "Inter IC". Sometimes the bus is called IIC or I²C bus. PoKeys devices support communication with I2C slave devices, connected to the PoExtBus/PoNET connector.
PoKeys user manual 1-wire 1-Wire is a device communications bus system designed by Dallas Semiconductor Corp. that provides low-speed data, signaling, and power over a single signal wire. 1-Wire is similar in concept to I²C, but with lower data rates and longer range. It is typically used to communicate with small inexpensive devices such as digital thermometers and weather instruments.
PoKeys user manual 7.14. EasySensors PoKeys57 series devices implement a feature called EasySensors. It is an improvement of the original support for various sensors in PoKeys56 series devices. EasySensors feature allows the user to setup up to 100 sensors on various communication buses (including I2C, 1-wire, DHTxx 1-wire and analog inputs). The feature is accessible in Peripherals > EasySensors menu.
PoKeys user manual Scan for 1-wire sensors The command opens the ‘Add 1-Wire sensor’ dialog that allows the user to select PoKeys pin, where the 1-Wire bus is connected to. By clicking ‘Scan’, PoKeys device scans the 1-Wire bus for devices. The EasySensors 1-wire bus implementation can detect multiple 1-Wire devices on the bus at once and thus simplifying the configuration process.
PoKeys user manual a) Using gain and offset: specify the gain and offset characteristics of the sensor. The gain specifies the number of sensor units per 1 V of analog voltage, while the offset specifies the sensor value of analog voltage input of zero. Figure 34: Analog sensor setup with gain / offset option b) Using two point mapping: in this mode, two sensor values with corresponding analog voltage must be entered into the fields provided. Gain and offset of the sensor are automatically calculated.
PoKeys user manual List of supported sensors - LM75 (Maxim, TI, NXP) temperature sensor for the temperature range -55 °C to +125 °C with the resolution of 0.5 °C. The sensor has configurable address and up to 8 sensors can be connected. - SHT21 (Sensirion) temperature and humidity sensor for the temperature range -40 °C to +125 °C with the resolution of 0.01 °C and air relative humidity in range 0 to 100 %.
PoKeys user manual 7.15. USB interface configuration The operation of the USB PoKeys devices can be adjusted in the Device > USB interface', as shown on the figure below. Figure 37: Accessing USB interface options By adjusting these options, the user is given the possibility to configure how device reacts on the system start, change the communication interval and configure which interfaces are visible to the system.
PoKeys user manual Enabling/disabling the interfaces Each USB PoKeys device uses 4 USB interfaces (i.e. USB devices) and thus appears as 'USB Composite Device' in the Device manager. If not needed, some (or all) interfaces can be disabled. Note: if all communication interfaces are disabled, configuration of the device will no longer be possible. In that case, follow the instructions in the section 'Restoring factory defaults' to restore the device's functionality. 61 www.poscope.
PoKeys user manual 7.16. Network device functionality PoKeys57CNC device can be connected to Ethernet 10/100 network with standard RJ-45 cable. By default, the device is set to use the DHCP functionality of the network router. User can later turn on or off the DHCP support. If DHCP is not required or available, fixed IP address must be defined for the device. To set the network settings of the device, go to Device menu and click Network device settings...
PoKeys user manual Default network settings DHCP: Port: Security: enabled 20055 Full access Connecting to device in other network When the device is not detected automatically (either there is a firewall blocking the UDP broadcast messages or the device is not in the same network as a computer), custom IP address of the device can be entered by clicking on the 'Network settings... ' button on the ‘Connect to device’ dialog. The following dialog appears.
PoKeys user manual Security Due to exposed nature of a network device, an authentication mechanism was implemented in network PoKeys that allows three levels of access rights: - Full access (default): the device is fully accessible from the network Read-only access: unauthorized users are allowed only to fetch a limited set of data from the device, while an authenticated users can acccess all functions of the device Full lock: unauthorised users can not neither read or write to the device.
PoKeys user manual Web interface (dashboard) Network PoKeys devices can be monitored through the simple web interface (that is already enabled by default). Figure 41: PoKeys device web interface The interface can be disabled or configured in dialog accessible via menu Device->Web interface configuration.
PoKeys user manual - Allow toggling outputs via web interface: if this field is checked, users can toggle the pins that are setup as outputs. If this field is unchecked, users are only presented with the status of each pin. Dashboard items configuration Up to 100 dashboard items can be configured. In order to add a new item, click on ‘Add new’ and enter the item information in the fields below (‘Selected item’ settings).
PoKeys user manual Figure 44: Custom unit editor Managing the web user accounts The dashboard configuration dialog contains a list of available users. To edit the user, double-click on the entry in the list - a ‘User account’ dialog will pop up, allowing the changes to user name and password. By default, PoKeys contains a user named ‘Admin’ with password set to ‘root0’. Both the username and password of this user can also be changed.
PoKeys user manual - devData.xml: information on the PoKeys device (network configuration and some other device data) sensorList.xml*: contains information on dashboard items configuration and value sensorList.json*: same as above, but in json format setS.html*: is used to change the sensor value setDO.html: is used to change digital output value The setS.html and setDO.html have the following syntax http:///setDO.
PoKeys user manual Registers Supported operations: 0x03: Read holding register 0x04: Read input register 0x06: Write single register 0x10: Write multiple registers Address (0-based) 0-1 Access (R – Read, W – Write) R 10-16 20-45 R RW Description Serial number of the device (PoKeys57 only) Analog inputs Encoder counter values (lower 16bit) Digital counter values PWM PWM period (MSB first) PWM duty1 (MSB first) – pin 22 100-154 RW 200-213 RW 200,201 202,203 ...
PoKeys user manual 303 A B 304 A B 10 F 9 G C D E Device 4 C D E Device 2 F G H A B F G H A B 8 H 5 C C D E Device 3 C D E Device 1 F G H F G H where 15 A 14 B 13 C 12 D 11 E Device 10 7 A 6 B 4 D 3 E 2 F 1 G 0 H Modbus word bit PoExtBus device bit mapping Device 9 Figure 46: Modbus configuration 70 www.poscope.
PoKeys user manual Reporting data to network server with PoKeys57CNC device PoKeys57CNC devices can automatically report sensor values to various network servers using the HTTP POST, HTTP PUT or text-only protocols. To use this reporting feature, user must specify reports type (RAW, UDP, Xively, Standard HTTP POST/PUT or custom), server IP, server port number and update rate.
PoKeys user manual More customized header: POST /myScript.php HTTP/1.1 Host: api.xively.com User-Agent: MyCustomDeviceAgent Content-Type: text/csv Content-Length: 010 Connection: close MyData: Test1234,-15000.00 The HTTP header without 'Connection' and 'Content-length' tags must be provided by the user The 'Connection' and 'Content-length' tags are automatically inserted by PoKeys device The above example must be specified as POST /myScript.php HTTP/1.1 Host: api.xively.
PoKeys user manual 4. Open Device > Server reports configuration. Check ‘Xively web service’ option. 5. Enter your Xively API key and Feed ID, created in step 3, leave other fields with default values Your Xively API key Your Xively Feed ID Figure 47: Reports server settings for Xively service 6. Select the update rate on the right 7. Click Send to device button. If you wish to save the settings to non-volatile memory, click ‘Send to device’ on main PoKeys screen. 8.
PoKeys user manual dashboard item to the Xively service, select ‘Server reports’ as the user. The ‘Item caption’ field is used to identify the datastream in the selected Xively feed. Make sure that item caption does not contain any invalid characters for Xively channel name (+, -, _, letters and numbers are allowed) Figure 48: Item configuration for the Xively service 9. Save the settings again by clicking 'Send to device' button. 10.
PoKeys user manual 12. Open your Xively feed by clicking the Feed URL – you should see the recorded data Figure 49: Xively feed overview page Setup for standard HTTP POST or PUT data upload Let's assume that the user wants to send sensor data to his server script that accepts POST method for data upload. The user's server script is available at the address www.userdomain.com/PoKeysDataUpload.asp.
PoKeys user manual Figure 50: Example of HTTP POST service setup 76 www.poscope.
PoKeys user manual 7.17. Changing User ID number Users can freely assign their own User ID number that represents a specific PoKeys device (enables distinguishing between different PoKeys devices in case there is more than one connected to a single host PC). To change the User ID number, go to ‘Device’ > ‘Change user ID’ menu. Simply enter any number between 0 and 255, and click the 'Change user ID' button. Figure 51: Device user ID dialog 7.18.
PoKeys user manual 8. Device recovery mode If configuration editor cannot be used to reconfigure the device, use the following steps to start the device in the recovery mode. Recovery mode can be used to clear the configuration or update the firmware. 1. Disconnect PoKeys57CNC device from USB and remove power supply 2. Locate LCD connector on the PoKeys57CNC device and short the pins 1 and 3 as shown below 3. Reconnect the PoKeys device to USB (or reconnect power) 4.
PoKeys user manual 9. Frequently asked questions What software must be installed to operate the device? On first use or when reconfiguring the device, the supplied software must be installed. If USB connection is to be used, device driver must be used that should be automatically installed by the setup package. Can I use both USB and Ethernet connections? Yes, both USB and Ethernet connections can be connected at the same time, but USB connection will have a priority over Ethernet.
PoKeys user manual 10. Errata information This section describes special limitations of the device. PoKeys device resets when external power supply is applied or removed If PoKeys device is connected to USB, the device resets when external power supply is either applied or removed. External pull-up resistor needed on the probing input On PoKeys57CNC v1.0, v1.1 and v1.2 hardware, external pull-up resistor is required for correct operation of the probing input. 80 www.poscope.
PoKeys user manual 11. Grant of license The material contained in this release is licensed, not sold. PoLabs grants a license to the person who installs this software, subject to the conditions listed below. Access The licensee agrees to allow access to this software only to persons who have been informed of and agree to abide by these conditions. Usage The software in this release is for use only with PoLabs products or with data collected using PoLabs products.
