Disable lockdev locking method on linux, can still be enabled manually

Author: emericg

CMakeLists.txt

@@ -75,7 +75,7 @@ endif(CMAKE_BUILD_TYPE STREQUAL "Debug")
 if(${CMAKE_SYSTEM_NAME} MATCHES "Linux")
 
     message(STATUS "Building on Linux plateform")
-    set(EXTRALIBS "lockdev")
+    #set(EXTRALIBS "lockdev")
 
 endif(${CMAKE_SYSTEM_NAME} MATCHES "Linux")
 

doc/BuildInstructions.md

@@ -14,7 +14,7 @@ Build system:
 * Doxygen (**ONLY** needed to generate the documentation)  
 
 Using Linux?
-* liblockdev (used to lock the serial port to a single software instance, which will save you from a lot of potential head scratching errors...)  
+* liblockdev (OPTIONAL) (used to lock the serial port to a single software instance, which will save you from a lot of potential head scratching errors...)  
 
 ### Building SmartServoFramework library (Linux and Mac OS X)
 

doc/SerialCommunication.md

@@ -42,9 +42,9 @@ You will need to make sure your software can access your serial port:
 It is important to guaranty that your application will be the only one to send commands and read the results back. Otherwise things will start to go wrong fast... We provide locking mechanisms in order to protect you against things like launching two instances of your application on the same port, or using one application and one SmartServoGui on two different ports.
 
 The framework will handle locking/unlocking the serial port if a locking method is available with your serial port implementation:
+* Linux: "flock()" support (default)
 * Linux: "lockfile" support
-* Linux: "liblockdev" support (default)
-* Linux: "flock()" support
+* Linux: "liblockdev" support
 * macOS: "lockfile" support
 * macOS: "TIOCEXCL ioctl" support (default)
 * Windows: TODO!

gui/SmartServoGui.pro

@@ -36,7 +36,6 @@ unix {
 
     unix:!macx {
         message("Building on Linux/BSD plateform")
-        LIBS += -llockdev
     }
     unix:macx {
         message("Building on MAC OS X plateform")

src/SerialPortLinux.cpp

@@ -33,9 +33,16 @@
 #include <sys/time.h>
 
 // Device lock support
-#include <lockdev.h>
+//#define LOCK_FLOCK
+//#define LOCK_LOCKFILE
+//#define LOCK_LOCKDEV
+
+#ifdef LOCK_FLOCK
 #include <sys/file.h>
-#define LOCK_LOCKDEV
+#endif
+#ifdef LOCK_LOCKDEV
+#include <lockdev.h>
+#endif
 
 // "open" and "close" calls
 #include <unistd.h>

src/SerialPortLinux.h

@@ -87,10 +87,10 @@ class SerialPortLinux: public SerialPort
      * \return True if a lock has been placed successfully for this serial device, false otherwise.
      *
      * We have several ways of doing that:
+     * - Use flock(). Should work on Linux and Mac if carefully implemented. Not working ATM.
      * - Use a file lock in "/tmp" directory. Will only work accross SmartServoFramework instances.
      * - Use a file lock in "/var/lock/lockdev" directory. Almost standard way of locking devices, but need "lock" group credential.
      * - Use a file lock with lockdev library. Standard way of locking devices, but need "lockdev" library.
-     * - Use flock(). Should work on Linux and Mac if carefully implemented. Not working ATM.
      */
     bool setLock();