Open Nav
  Back to guides

Getting started with your Dev Kit

Updated Jun 08, 2017

Thanks for purchasing a Poynt Dev Kit! (If you haven't gotten one yet, you can order one here.

Follow the easy steps here to get your dev kit set up and ready for development. You'll need the following to get started:

  • A Poynt terminal Dev Kit
  • A Windows, Mac, or Linux computer with Android SDK and API Version 19 (KitKat) installed
  • A Micro-USB cable

Step 1: Enable Developer Mode

In order to install development applications (APKs) on your device, you will have to put it into Developer Mode.

Warning: This change is irreversible! Putting a production terminal into developer mode will disable the terminal's ability to process real payments. Of course, you will still be able to process test transactions during development.

  1. Put your device into Fastboot mode by holding the power and volume up button while the device is powered off. For more information about what Fastboot does, see http://elinux.org/Android_Fastboot.

    fastboot0.png

  2. Select Fastboot Protocol from the Fastboot menu (press volume down button to navigate, then the power button to select). The screen will flicker and return to Fastboot menu.

    fastboot screen1.jpg

  3. Make sure you have the Android SDK tools as well as the fastboot command installed on your computer, and ensure your device is properly connected to your computer via a Micro-USB cable. See the For Windows Users and For Mac OS X/Linux Users sections below for specific steps you may have to take on each platform.

  4. Run this command to initiate the developer mode process:
    fastboot oem developer

    fastboot developer mode.png

  5. Read the instructions on the Poynt Terminal. Press the volume down button to move the selection to Enter developer mode and press the Power button to select. At this point your device will clear its cache and the device state in the bootloader screen should show Unlocked or Developer mode.

  6. Reboot your device.

    terminal fastboot2.png

  7. Activate your Poynt terminal in Step 2!
    Note: If you've previously activated your device, you can reuse your test MID and TIDs to reactivate.

For Windows Users

Open a command prompt with Administrator privileges. Navigate to the directory that contains the fastboot.exe executable. If you installed the Android SDK, this will usually be located in C:\Users\You\AppData\Local\Android\sdk\platform-tools\.

Verify that your Poynt Terminal is in fastboot mode and is being seen by fastboot by issuing the command fastboot devices. The output should show your device's serial number:

C:\Users\You\AppData\Local\Android\sdk\platform-tools > fastboot devices  
P61SERIALNUMBER fastboot  

Tip: If fastboot is not showing your device's serial number, please see the "Troubleshooting fastboot" section here.

Add the following configuration block to the [Google.NTamd64] and [Google.NTx86] sections of C:\Users\You\AppData\Local\Android\sdk\extras\google\usb_driver\android_winusb.inf:

;Poynt
%SingleAdbInterface% = USB_Install, USB\VID_2BF9&PID_3302
%CompositeAdbInterface% = USB_Install, USB\VID_2BF9&PID_3302&MI_01
;Poynt Fastboot
%SingleAdbInterface% = USB_Install, USB\VID_0955&PID_CF01
%CompositeAdbInterface% = USB_Install, USB\VID_0955&PID_CF01&MI_01

Note: If the google directory does not have usb_drive you may need to download Google USB drivers from the Android Developer Site.

In addition, update the adb_usb.ini config file to include the following:

# ANDROID 3RD PARTY USB VENDOR ID LIST -- DO NOT EDIT.
# USE 'android update adb' TO GENERATE.
# 1 USB VENDOR ID PER LINE.
0x2BF9  
0x0955  

For Mac OS X/Linux Users

Add {SDK_LOCATION}\sdk\platform-tools to your PATH environment variable. To find out your Android SDK location, open Android Studio, then go to Android Studio->Preference->System Settings->Android SDK.

On some Linux distributions, you may be able to install Android SDK tools with apt-get:

apt-get install android-tools-adb android-tools-fastboot  

Ensure your device is properly connected via USB by running fastboot devices on your host machine.

If your host machine runs on Linux and does not recognize the device please follow the instructions starting at Step 3 in the Android User Guide. You can find out the vendor id by running lsusb in the Terminal window.

If your are unable to see the device after following the steps above, run the following command:

echo "0x2BF9" >> ~/.android/adb_usb.ini  

For Linux, you may have to add this line:

SUBSYSTEM=="usb", ATTR{idVendor}=="2bf9", MODE="0664", GROUP="plugdev" # Poynt  

to /etc/udev/rules.d/51-android.rules

Step 2: Activate your Poynt Terminal