Serial4j: A JNI lib for UNIX Terminal Control

HelloSerial4j/CommonVariables.sh

@@ -0,0 +1,36 @@
+#**
+#* Ccoffee Build tool, manual build, alpha-v1.
+#*
+#* @author pavl_g.
+#*#
+
+# Bash colors using ANSI 
+# favored the 24-bit (3 colors * 8-bit for each one<255>) color system
+# Colors
+# process failure color
+RED_C='\033[38;2;255;50;50m'
+# success color
+GREEN_C='\e[38;2;0;180;0m'
+# extra
+WHITE_C='\e[38;2;255;255;255m'
+# Java color
+ORANGE_C='\e[38;2;250;155;0m'
+# C alternative color
+DARK_GREY_C='\e[1;30m'
+# kotlin color
+VIOLET_C='\e[38;2;217;80;223m'
+# groovy color
+CYAN_C='\e[38;2;0;155;255m'
+# C++ color
+MAGNETA_C='\e[38;2;170;150;150m'
+# Scala color
+BRIGHT_RED_C='\e[38;2;200;120;120m'
+# Highlights
+RED_H='\033[1;41m'
+GREEN_H='\033[1;42m'
+WHITE_H='\e[1;47m'
+# Flashes
+RED_C_F='\033[1;5;41m'
+GREEN_C_F='\033[1;5;42m'
+WHITE_C_F='\e[1;5;47m'
+RESET_Cs='\033[0;0m'

HelloSerial4j/JAVAHOME.sh

@@ -0,0 +1,13 @@
+#**
+#* Ccoffee Build tool, manual build, alpha-v1.
+#* @author pavl_g.
+#*#
+# DONOT DELETE OR RENAME
+## EDIT YOUR CUSTOM JAVAHOME FROM HERE, Ccoffee uses this custom java home to create new aliases for your script !
+compile_dir=`pwd`
+build_dir="${compile_dir%/*}"
+project_dir="${build_dir%/*}"
+root_dir="${project_dir%/*}"
+JAVA__HOME=$root_dir'/jdk-19/bin'
+export JAVA_HOME="${JAVA__HOME%/*}"
+

HelloSerial4j/NDKPATH.sh

@@ -0,0 +1,7 @@
+#**
+#* Ccoffee Build tool, manual build, alpha-v1.
+#* @author pavl_g.
+#*#
+# DONOT DELETE OR RENAME
+## EDIT YOUR CUSTOM NDKBASEHOME FROM HERE, Ccoffee uses this custom NDK home to create new aliases for your script !
+NDK__BASEHOME=/home/twisted/Android/Sdk/ndk/21.1.6352462

HelloSerial4j/README.md

@@ -0,0 +1,36 @@
+## The Serial4j Architectural HAL:
+
+![image](https://user-images.githubusercontent.com/60224159/189999625-fd667e7c-b219-4aa8-a91f-c9809dcef225.png)
+
+Serial4j is a terminal io library primarialy built on top of POSIX base file API `<fcntl>` for file control operations, `<unistd>` for Unix std R/W operations and `<dirent>` for directory entry dir operations.
+
+## Quick Overview:
+
+- Java Implementation of the binding library: 
+
+| Entity/Class | Usages | 
+|---------------|----------------|
+| `com.serial4j.core.serial` | A java package that provides the base implementation code for the serial4j API to control a terminal device. |
+| `TerminalDevice.java` | A java class that provides a final implementation code for the `NativeTerminalDevice.java`, the api opens, initializes and R/W from/to a terminal device. |
+| `Permissions.java` | A java class that provides the permissions for the terminal io operations. |
+| `BaudRate.java` | A java enum class that provides the constants for the available POSIX termios bit speed. |
+| `SerialPort.java` | A java wrapper class that wraps a serial port with a name and a port descriptor. |
+| `ReadConfiguration.java` | A java enum class that provides an implementation for the various read configurations defined by the POSIX `termios-c_cc.h`. |
+| `NativeTerminalDevice.java` | A java class that provides a base implementation for the Serial4j base native code. |
+|                           |                          |
+| `com.serial4j.core.control` | A java package that provides the terminal flags for the terminal device including control, local, input and output flags. |
+| `TerminalFlag.java` | A java abstract class that provides the base implementation for a terminal flag. | 
+| `TerminalControlFlag.java` | A java class that provides an implementation for the POSIX terminal control mode flags, e.g: CREAD for receive enable, CS8 for charachter size 8-bits,...etc. |
+| `TerminalLocalFlag.java` | A java class that provides an implementation for the POSIX terminal local mode flags, e.g: ECHO for enabling echoing charachters, ECHOCTL for enabling echoing control charachters visually on the terminal. |
+| `TerminalInputFlag.java` | A java class that provides an implementation for the POSIX terminal input mode flags, e.g: IUTF8 for enabling utf-8 input, ICRNL for mapping (translating) CR into NL on input. | 
+| `TerminalOutputFlag.java` | A java class that provides an implementation for the POSIX terminal output mode flags, e.g: OCRNL for mapping (translating) CR to NL on output. |
+|                           |                          |
+| `com.serial4j.core.throwable` | A java package that provides java exceptions as translations to C native error codes. |
+
+- Java Binding library for the native API:
+
+- Direct Implementation of the POSIX base file/directory and terminal IO APIs:
+
+
+- Unix/POSIX Base APIs:
+