Upgrade examples

Author: manuelbl

README.md

@@ -4,16 +4,17 @@
 
 *Java Does USB* is a Java library for working with USB devices. It allows to query information about all conntected USB devices and to communicate with USB devices using custom / vendor specific protocols. (It is not intended for communication with standard types of USB devices such as mass storage devices, keyboards etc.)
 
-The library uses the [Foreign Function & Memory API](https://github.com/openjdk/panama-foreign) to access native APIs of the underlying operating system. It is written entirely in Java and does not need JNI or any native third-party library. The *Foreign Function & Memory API* (aka as project Panama) is currently in preview and will leave preview with Java 22. Currently, it can be used with Java 19, Java 20 or Java 21 (with preview features enabled).
+The library uses the [Foreign Function & Memory API](https://github.com/openjdk/panama-foreign) to access native APIs of the underlying operating system. It is written entirely in Java and does not need JNI or any native third-party library. The *Foreign Function & Memory API* (aka as project Panama) has been introduced with Java 22. Older versions of this library can be used with preview versions of the API that were available in Java 19, Java 20 or Java 21 (with preview features enabled).
 
 | Version | Main New Features | Compatibility |
 | - | - | - |
+| 1.0.x | Release for final Java API | JDK 22 |
 | 0.7.x | New setter/getter names for improved Kotlin support; Kotlin examples | JDK 21 |
 | 0.6.x | Support for JDK 21; better handling of composite devices on Windows | JDK 21 |
 | 0.5.x | Support for JDK 20; high-throuput I/O streams | JDK 20 |
 | 0.4.x | Early release | JDK 19 |
 
-*Note: The main branch and published versions ≥ 0.6.0 work with JDK 21 only. For JDK 20, use version 0.5.*. For JDK 19, use version 0.4.x.
+*Note: The main branch and published versions ≥ 1.0 work with JDK 22 and later only. For JDK 21, user version 0.7.*. For JDK 20, use version 0.5.*. For JDK 19, use version 0.4.x.
 
 
 ## Features
@@ -48,14 +49,14 @@ If you are using Maven, add the below dependency to your pom.xml:
 <dependency>
       <groupId>net.codecrete.usb</groupId>
       <artifactId>java-does-usb</artifactId>
-      <version>0.7.1</version>
+      <version>1.0.0-SNAPSHOT</version>
 </dependency>
 ```
 
 If you are using Gradle, add the below dependency to your build.gradle file:
 
 ```groovy
-compile group: 'net.codecrete.usb', name: 'java-does-usb', version: '0.7.1'
+compile group: 'net.codecrete.usb', name: 'java-does-usb', version: '1.0.0-SNAPSHOT'
 ```
 
 ```java
@@ -90,23 +91,23 @@ public class EnumerateDevices {
 
 ## Prerequisite
 
-- Java 21, preview features enabled (available at https://www.azul.com/downloads/?package=jdk)
+- Java 22 (available at https://www.azul.com/downloads/?package=jdk)
 - Windows (x86 64-bit), macOS (x86 64-bit, ARM 64-bit) or Linux 64 bit (x86 64-bit, ARM 64-bit)
 
-For JDK 20, use the latest published version 0.5.x. For JDK 19, use the latest published version 0.4.x.
+For JDK 21, use the latest published version 0.7.x. For JDK 20, use the latest published version 0.5.x. For JDK 19, use the latest published version 0.4.x.
 
 
 ## Platform-specific Considerations
 
 
 ### macOS
 
-No special considerations apply. Using this library, a Java application can connect to any USB device and claim any interfaces that isn't claimed by an operating system driver or another application. Standard operation-system drivers can be unloaded if the application is run with root privileges.
+No special considerations apply. Using this library, a Java application can connect to any USB device and claim any interfaces that isn't claimed by an operating system driver or another application. Standard operation-system drivers can be unloaded if the application is run with root privileges. It runs both on Macs with Apple Silicion and Intel processors.
 
 
 ### Linux
 
-*libudev* is used to discover and monitor USB devices. It is closely tied to *systemd*. So the library only runs on Linux distributions with *systemd* and the related libraries. The majority of Linux distributions suitable for desktop computing (as opposed to distributions optimized for containers) fulfill this requirement.
+*libudev* is used to discover and monitor USB devices. It is closely tied to *systemd*. So the library only runs on Linux distributions with *systemd* and the related libraries. The majority of Linux distributions suitable for desktop computing (as opposed to distributions optimized for containers) fulfill this requirement. It runs on both Intel and ARM64 processors.
 
 Similar to macOS, a Java application can connect to any USB device and claim any interfaces that isn't claimed by an operating system driver or another application. Standard operation system drivers can be unloaded (without the need for root privileges).
 
@@ -129,17 +130,11 @@ USB devices can implement certain control requests to instruct Windows to automa
 
 The test devices implement the required control requests. So the driver is installed automatically.
 
-The library has not been tested on Windows for ARM64. It might or might not work.
+Windows for ARM64 is not yet supported. A port is probably easy, provided you have hardware to test it.
 
 
 ### Troubleshooting
 
-#### `ClassFormatError` (all platforms)
-
-The error `java.lang.ClassFormatError: Illegal field name "" in class net/codecrete/usb/windows/WindowsUsbDeviceRegistry` is caused by a bug in JDK 21, which has been fixed in the mean-time. Please upgrade to the latest release of JDK 21 (at least 21.0.1).
-
-
-
 ### 32-bit versions
 
 The Foreign Function & Memory API has not been implemented for 32-bit operating systems / JDKs  (and likely never will be).
@@ -170,11 +165,11 @@ mvn clean test
 If they are run from an IDE (such as IntelliJ IDEA), you must likely configure VM options to enable preview features and allow native access:
 
 ```
---enable-preview --enable-native-access=net.codecrete.usb
+--enable-native-access=net.codecrete.usb
 ```
 
 Or (if modules are ignored):
 
 ```
---enable-preview --enable-native-access=ALL-UNNAMED
+--enable-native-access=ALL-UNNAMED
 ```

examples/bulk_transfer/.mvn/wrapper/maven-wrapper.properties

@@ -14,5 +14,5 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.3/apache-maven-3.9.3-bin.zip
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
 wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar

examples/bulk_transfer/README.md

@@ -4,16 +4,16 @@ This sample shows how to find a device, open it and transfer data from and to bu
 
 ## Prerequisites
 
-- Java 21
+- Java 22
 - Apache Maven
 - 64-bit operating system (Windows, macOS, Linux)
 - A USB device with bulk IN and OUT endpoints (e.g. the test device, see https://github.com/manuelbl/JavaDoesUSB/tree/main/test-devices/loopback-stm32)
 
 ## How to run
 
-### Install Java 21
+### Install Java 22
 
-Check that *Java 21* is installed:
+Check that *Java 22* is installed:
 
 ```shell
 $ java -version
@@ -39,24 +39,22 @@ $ mvn compile exec:exec
 [INFO] Scanning for projects...
 [INFO] 
 [INFO] --------------< net.codecrete.usb.examples:bulk-transfer >--------------
-[INFO] Building bulk-transfer 0.7.1
+[INFO] Building bulk-transfer 1.0.0-SNAPSHOT
 [INFO] --------------------------------[ jar ]---------------------------------
 [INFO] 
-[INFO] --- maven-resources-plugin:3.0.2:resources (default-resources) @ bulk-transfer ---
-[INFO] Using 'UTF-8' encoding to copy filtered resources.
-[INFO] skip non existing resourceDirectory /Users/me/Documents/JavaDoesUSB/examples/bulk_transfer/src/main/resources
+[INFO] --- maven-resources-plugin:3.3.1:resources (default-resources) @ bulk-transfer ---
+[INFO] skip non existing resourceDirectory /home/user/Documents/JavaDoesUSB/examples/bulk_transfer/src/main/resources
 [INFO] 
-[INFO] --- maven-compiler-plugin:3.8.0:compile (default-compile) @ bulk-transfer ---
-[INFO] Changes detected - recompiling the module!
-[INFO] Compiling 1 source file to /Users/me/Documents/JavaDoesUSB/examples/bulk_transfer/target/classes
+[INFO] --- maven-compiler-plugin:3.12.1:compile (default-compile) @ bulk-transfer ---
+[INFO] Nothing to compile - all classes are up to date.
 [INFO] 
-[INFO] --- exec-maven-plugin:3.1.0:exec (default-cli) @ bulk-transfer ---
+[INFO] --- exec-maven-plugin:3.1.1:exec (default-cli) @ bulk-transfer ---
 6 bytes sent.
 6 bytes received.
 [INFO] ------------------------------------------------------------------------
 [INFO] BUILD SUCCESS
 [INFO] ------------------------------------------------------------------------
-[INFO] Total time:  1.259 s
-[INFO] Finished at: 2023-03-23T14:10:17+01:00
+[INFO] Total time:  1.228 s
+[INFO] Finished at: 2024-02-18T16:23:29+01:00
 [INFO] ------------------------------------------------------------------------
 ```