• View
• Edit
• History
• Print

Nrjavaserial

nrjavaserial is one of the Java Serial Port Interfaces.

nrjavaserial is a port of RxTx that includes the shared libraries in the jar file.

Debugging

To debug nrjavaserial Java code, set -Dgnu.io.log.mode=PRINT_MODE, for example:

To debug C code, edit nrjavaserial/src/main/c/src/SerialImp.c and add

and rebuild.

Building

We need to rebuild nrjavaserial because of RxTx Hanging.

1. Check out the repo:

2. Install gradle For Mac OS X:

  sudo port install gradle

For Ubuntu, a recent version of gradle is needed, otherwise Gradle fails with jcenter missing

  sudo add-apt-repository ppa:cwchien/gradle
  sudo apt-get update
  sudo apt-get install gradle

3. To rebuild the C version, see Building the Native Code Portion below, to rebuild just the Java:

  cd nrjavaserial
  gradle build

If you have trouble, see Problems 4. Running gradle build creates ./build/libs/nrjavaserial-3.11.0.jar, which gets copied to $PTII/lib with a name that includes .devel:

  cp ./build/libs/nrjavaserial-3.11.0.jar $PTII/lib/nrjavaserial-3.11.0.devel.jar

5. Optional: Configure looks for $PTII/lib/nrjavaserial-3.11.0.devel.jar. If you want to change the name of the file, then to update which version of nrjavaserial ptolemy uses, update $PTII/configure.in by searching for the previous nrjavaserial-X.Y.Z.jar file and substituting in the new name:

6. Run commit configure.in, run autoconf and commit configure:

7. Add the new library, delete the old library (Could be done in one step)

Building the Native Code Portion of nrserialjava

See https://github.com/NeuronRobotics/nrjavaserial, which says to run make target where the target is one of arm, linux64, osx. Other platforms are supported as well, see nrjavaserial/Makefile.

Building the Native Code Under OS X

https://github.com/NeuronRobotics/nrjavaserial says:

To do this, we download an old version of Xcode and install the MacOSX10.5.pkg.

1. Download Xcode 3.2.6. 4.1Gig, use a fast connection.. An Apple Developer ID is necessary. Follow the link, log in and then follow the link again to get to the right page.
2. The installer will open. Don't install it
3. In a terminal, run
   open /Volumes/Xcode\ and\ iOS\ SDK/Packages/

   [$[Get Code]]
   Or, if you don't want to run the terminal, then go to the window with the Xcode installer and click on Go -> Go to Folder and enter packages
4. In the finder, browse to the MacOSX10.5.pkg, double click on it and install it.
5. Create links:
    sudo mkdir /Developer
    sudo ln -s /SDKs /Developer/

   [$[Get Code]]
6. Make nrjavaserial:
   make osx

   [$[Get Code]]
7. Update the ptII library:
   cp ./build/libs/nrjavaserial-3.11.0.jar $PTII/lib/nrjavaserial-3.11.0.devel.jar

   [$[Get Code]]

Building the Native Code Under Ubuntu

Run

  make linux64

Update the PTII Jar File

Update the PTII Jar File ''note that the actual name of the file in $PTII/lib may change over time.

 cp ./build/libs/nrjavaserial-3.11.0.jar $PTII/lib/nrjavaserial-3.11.0.devel.jar 

Problems

Gradle fails with jcenter missing

Under Ubuntu 14.04.3 LTS, running gradle build fails with Could not find method jcenter() for arguments []

The problem is that gradle is old, see http://stackoverflow.com/questions/27470443/could-not-find-method-jcenter-for-arguments-on-repository-container

The solution is at http://askubuntu.com/questions/328178/gradle-in-ubuntu

  sudo add-apt-repository ppa:cwchien/gradle
  sudo apt-get update
  sudo apt-get install gradle

After the install, the version is updated:

See Also

• Java Serial Port Interfaces
• https://github.com/NeuronRobotics/nrjavaserial
• RxTx
• We are having problems with RxTx hanging and a thread busy waiting. See RxTx Hanging.
• Exiting the model is crashing Vergil, see RxTx Crashing Vergil.
• The message RXTX fhs_lock(): Error: opening lock file appears, see RxTx Error Opening Lock File.
• Running SerialHelloWorld was crashing in Java_gnu_io_RXTXPort_readArray, see Nrjavaserial crashing in readArray