Using a TSP100 on Linux Ubuntu 9.

04 with JavaPOS

Created September 2009

This application note shows how to use a TSP100 on Ubuntu Linux 9.04 with the JavaPOS driver.
*Note: Please have the printer OFF during the Software installation

Installing the TSP100 SDK ‘libxerces27.dev’

1. Download the SDK for TSP100 on Google.

2. Click on the link from the website packages.ubuntu.com (shown below).

3. Click on the 2nd option “libxerces27 (=2.7.0-5) / validating XML parser library for C++”.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

4. Click on the i386 link.

5. Click Open or Save, then OK.

6. Click Install Package to continue.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

7. It will confirm at the bottom that the installation is complete.

Installing Star JAVAPOS

1. The Java development kit must be installed to use the JavaPOS driver. Click on System at the top menu bar, then
Administration/Synaptic Package Manager.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

2. Enter the password if prompted.

3. Search for sunjava6.jdk in the Quick search field.

4. When the package appears, right-click on it and click on Mark for Installation.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

5. Click the Mark button.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

6. All other necessary packages will be selected automatically.

Click Apply at the top.

7. Click the Apply button.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

The files will download.

8. Agree to the license terms and click Forward.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

9. Click the Close button.

10. Open the Synaptic Package Manager again and ensure there is a green box next to sun-java6-jdk.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

Downloading and Installing the Star Micronics JavaPOS Driver

1. Turn the power to the TSP100 on.

2. Obtain the Star Micronics JavaPOS Package (starjavapos_linux_Ver1.9.13) at our website: www.starmicronics.com

3. Open the “starjavapos_linux_Ver1.9.13” folder. Right click on “jpos.xml” and click on Open with Text Editor.

4. Search for your printer model (ie: TSP100) and copy the Logical Name.

5. Revisit the Star JavaPOS folder and locate the sample receipt file named “StarReceiptTest.java”.
Right click and click Open with Text Editor.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

6. Search for the printer.open statement.

7. Paste the printer’s Logical Name into the “printer.open” section as shown below.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

8. Scroll up to the top of the StarReceiptTest.java file to the “Usage instructions – Linux” section.

9. Open Terminal (Applications/Accessories/Terminal)

Change the directory to the starjavapos_linux_Ver1.9.13 folder. Type “cd” and then drag the name
starjavapos_linux_Ver1.9.13 into Terminal.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com
 Using a TSP100 on Linux Ubuntu 9.04 with JavaPOS

10. Refer back to the StarReceiptTest.java file and copy “javac –classpath jpos191-controls.jar:jcl.jar StarReceipt
Test.java”.

Type “sudo” in Terminal, then paste the command line and hit enter.

Enter the password if prompted.

Terminal will confirm that the command was accepted and a Sample Test receipt will print out.

Congratulations! You have successfully printed using the Star Micronics JavaPOS driver.

Star Micronics America, Inc. 1150 King Georges Post Road, Edison, NJ 08837-3729
Tel: (732) 623-5500 Fax: (732) 623-5590 Web: www.starmicronics.com