StdCall DLL in Java einbinden

[TDO88]

Hallo Zusammen,

ich habe eine DLL von einem Messgerät, welche ich in eine Java Applikation einbinden möchte.
Laut Hersteller benutzt die DLL die calling convention stdcall.
Die Header Datei der DLL habe ich angehängt (Dateiendung auf .txt geändert)
Die Header Datei habe ich durch den jnaerator gejagt und mir daraus ein Interface für meine Anwendung gebastelt.

public interface FPS3010DLL extends StdCallLibrary {
        //public static final String JNA_LIBRARY_NAME = LibraryExtractor.getLibraryPath((System.getProperty("user.dir") + "\\lib\\fps3010.dll"), true, FPS3010DLL.class);
    //public static final NativeLibrary JNA_NATIVE_LIB = NativeLibrary.getInstance(FPS3010DLL.JNA_LIBRARY_NAME, MangledFunctionMapper.DEFAULT_OPTIONS);
    //public static final FPS3010DLL FPSINSTANCE = (FPS3010DLL)Native.loadLibrary(FPS3010DLL.JNA_LIBRARY_NAME, FPS3010DLL.class, MangledFunctionMapper.DEFAULT_OPTIONS);

    /**
     *
     */
    public static interface FPS_InterfaceType {
        /**
         * < Device invalid / not connected<br>
         * <i>native declaration : line 97</i>
         */
        public static final int IfNone = (int)0;
        /**
         * < Device connected via USB<br>
         * <i>native declaration : line 98</i>
         */
        public static final int IfUsb = (int)1;
        /**
         * < Device connected via ethernet (TCP/IP)<br>
         * <i>native declaration : line 99</i>
         */
        public static final int IfTcp = (int)2;
        /**
         * < All physical interfaces<br>
         * <i>native declaration : line 100</i>
         */
        public static final int IfAll = (int)3;
    };

    /**
     *
     */
    public static final int FPS_Error           = (int)-1;

    /**
     *
     */
    public static final int FPS_Ok              = (int)0;

    /**
     *
     */
    public static final int FPS_Timeout         = (int)1;

    /**
     *
     */
    public static final int FPS_NotConnected    = (int)2;

    /**
     *
     */
    public static final int FPS_DriverError     = (int)3;

    /**
     *
     */
    public static final int FPS_DeviceLocked    = (int)7;

    /**
     *
     */
    public static final int FPS_Unknown         = (int)8;

    /**
     *
     */
    public static final int FPS_NoDevice        = (int)9;

    /**
     *
     */
    public static final int FPS_NoAxis          = (int)10;

    /**
     *
     */
    public static final int FPS_ParamOutOfRg    = (int)11;

    /**
     *
     */
    public interface FPS_PositionCallback extends Callback {

            /**
             *
             * @param devNo
             * @param length
             * @param index
             * @param positions
             * @param markers
             */
            void apply(int devNo, int length, int index, PointerByReference positions, PointerByReference markers);
    };
    /**
     * Discover devices<br>
     * *  The function searches for connected FPS3010 devices on USB and LAN and<br>
     *  initializes internal data structures per device. Devices that are in use<br>
     *  by another application or PC are not found.<br>
     *  The function must be called before connecting to a device and must not be<br>
     *  called as long as any devices are connected.<br>
     * *  The number of devices found is returned. In subsequent functions, devices<br>
     *  are identified by a sequence number that must be less than the number returned.<br>
     *  @param   ifaces    Interfaces where devices are to be searched<br>
     *  @param   devCount  Output: number of devices found<br>
     *  @return            Error code<br>
     * Original signature : <code>int FPS_discover(FPS_InterfaceType, unsigned int*)</code><br>
     * <i>native declaration : line 156</i><br>
     * use the safer methods {@link #FPS_discover(int, java.nio.IntBuffer)} and {@link #FPS_discover(int, com.sun.jna.ptr.IntByReference)} instead
     */

    int FPS_discover(int ifaces, IntByReference devCount);
    /**
     * Discover devices<br>
     * *  The function searches for connected FPS3010 devices on USB and LAN and<br>
     *  initializes internal data structures per device. Devices that are in use<br>
     *  by another application or PC are not found.<br>
     *  The function must be called before connecting to a device and must not be<br>
     *  called as long as any devices are connected.<br>
     * *  The number of devices found is returned. In subsequent functions, devices<br>
     *  are identified by a sequence number that must be less than the number returned.<br>
     *  @param   ifaces    Interfaces where devices are to be searched<br>
     *  @param   devCount  Output: number of devices found<br>
     *  @return            Error code<br>
     * Original signature : <code>int FPS_discover(FPS_InterfaceType, unsigned int*)</code><br>
     * <i>native declaration : line 156</i>
     */
        @Deprecated
    int FPS_discover(int ifaces, IntBuffer devCount);
    /**
     * Device information<br>
     * *  Returns available information about a device. The function can not be<br>
     *  called before @ref FPS_discover but the devices don't have to be<br>
     *  @ref FPS_connect "connected" . All Pointers to output parameters may<br>
     *  be zero to ignore the respective value.<br>
     *  @param   devNo     Sequence number of the device<br>
     *  @param   id        Output: programmed hardware ID of the device<br>
     *  @param   address   Output: The device's interface address if applicable.<br>
     *                     Returns the IP address in dotted-decimal notation or the<br>
     *                     string "USB", respectively. The string buffer should be<br>
     *                     at least 16 bytes long.<br>
     *  @param   connected Output: if the device is connected<br>
     *  @return            Error code<br>
     * Original signature : <code>int FPS_getDeviceInfo(unsigned int, int*, char*, bln32*)</code><br>
     * <i>native declaration : line 175</i><br>
     * use the safer methods {@link #FPS_getDeviceInfo(int, java.nio.IntBuffer, java.nio.ByteBuffer, java.nio.IntBuffer)} and {@link #FPS_getDeviceInfo(int, com.sun.jna.ptr.IntByReference, com.sun.jna.Pointer, com.sun.jna.ptr.IntByReference)} instead
     */

Die anderen Methoden habe ich jetzt mal weggelassen.
Aufgerufen wird das ganze wie folgt:

IntByReference devCount = new IntByReference(-1);
String DLLPath = System.getProperty("user.dir")+ "\\fps3010.dll";
FPS3010INST = (FPS3010DLL) Native.loadLibrary(DLLPath, FPS3010DLL.class);
           
returnfunction = FPS3010INST.FPS_discover(1, devCount);
if(devCount.getValue() < 1)
     throw new Exception("Fehler: Kein Gerät am USB gefunden!");

Auf meinem Rechner/Entwicklungsumgebung (Netbeans, Win10, 64 Bit) funktioniert alles bestens.
Die Software soll aber auf dem Zielrechner unter Win7, 32-Bit laufen.
Wenn ich die Software dort laufen lasse bekomme ich die Fehlermeldung aus dem CMD_Debug Bild im Anhang.

Ich bin aktuell etwas am verzweifeln. Ich hoffe hier kann mir jemand nochmal einen Tipp geben, wie ich das Problem lösen kann.
Soweit ich weiß, ignorieren 64-Bit Windows Systeme die stdcall Bezeichnung. Das würde erklären, warum es auf meinem System läuft und auf dem 32-Bit System nicht.
Allerdings weiß ich nicht, was ich ändern muss um die stdcall Bezeichnung für ein 32-Bit System zu integrieren.

Gruß
TDO

 

[httpdigest]

Ja, stdcall unter Windows x86 (bzw. 32 bit) verwendet "Name Decoration", um den Namen einer exportierten C-Funktion zu ermitteln, wie er in einer shared Library eingetragen wird.
Unter Windows x86-64 ist das leider nicht mehr der Fall, und der Name wird undekoriert verwendet.
Das heißt dann auch, dass du zwei DLLs hast, eine für x86 und eine für x86-64?
Öffne die doch mal im "Dependency Walker" (googlen) und lass dir die Namen der exportierten Funktionen anzeigen.

 

[TDO88]

Hallo httpdigest,
vielen Dank für deine Antwort.
Ja, ich habe sowohl eine 64, also auch eine 32-Bit DLL.
Den Dependency Walker hatte ich schonmal laufen lassen, daraus konnte ich aber leider keine neuen Schlüsse ziehen.
Anbei ein Screenshot davon

 

[httpdigest]

Ja, das ist eine 32-bit Windows stdcall DLL mit Name Mangling. Allerdings ist hier anscheinend noch die Besonderheit, dass die Namen noch alle mit einem Unterstrich anfangen. Die exportierten Funktionen siehst du in der zweiten Liste von oben auf der rechten Seite. Also nicht nur der C Name plus @ Zeichen gefolgt von Bytelänge der Parameter, sondern noch ein vorangestellten Unterstrich.
Zeig auch nochmal den Inhalt der 64-bit DLL.

 

[TDO88]

Genau das ist mir gerade auch aufgefallen!
Bei der 64-Bit DLL sind die Unterstriche am Anfang nicht da.

 

[httpdigest]

Als nächsten Schritt würde sich ja mal anbieten, zur Laufzeit in JNA reinzudebuggen, insbesondere hier: https://github.com/java-native-acce.../sun/jna/win32/StdCallFunctionMapper.java#L85

 

[TDO88]

Habe auf dem 32-Bit Zielrechner leider keine Entwicklungsumgebung installiert

 

[httpdigest]

Es geht auch, wenn du auf deinem 64-bit System eine 32-bit JVM installierst und die Anwendung und per 32-bit JVM startest. Dann läuft deine Anwendung in 32-bit Modus und kann auch 32-bit DLLs laden.

 

[TDO88]

Okay, damit bin ich dann erstmal etwas beschäftigt, das jetzt umzusetzen.
Eine Frage habe ich dazu aber noch.
Ich habe die jna.jar eingebunden. Wie komme ich dann an die Innereien davon um das zu debuggen?

 

[httpdigest]

Du holst dir die Sourcen. Z.B. von GitHub oder das Sources Jar via Maven.

 

[TDO88]

Guten Morgen,

ich habe meine Umgebung jetzt auf 32-Bit umgestellt und bekomme nun auch hier die ganz oben beschriebene Fehlermeldung.
Habe dann von Maven das sources.jar heruntergeladen und eingebunden. Jetzt sehe ich auch den Quelltext der StdCallFunctionMapper.java Datei und habe dort einen Breakpoint gesetzt, der aber leider nicht erreicht wird. Es kommt vorher schon die Fehlermeldung. Und nun?

Gruß
TDO

 

[TDO88]

Komme ich irgendwie an die Namen der verfügbaren Funktionen der DLL ran?!

 

[httpdigest]

Guck dir doch mal deinen Stacktrace an und setze entsprechend Breakpoints and den Stellen, wo die Auflösung auf die Funktion fehlschlägt, also z.B.: com.sun.jna.Function:179
Die Liste der exportierten Funktionen einer DLL siehst du, wie gesagt, mit Dependency Walker.
Bezüglich JNA ist es nur wichtig, zu wissen, wie JNA denn aus einem Java Methodennamen (der eine native Funktion repräsentiert) den Namen einer exportierten DLL Funktion generiert. Step-Debugge einfach durch und du wirst die Stelle in JNA finden.

 

[TDO88]

Also, wenn ich das im Singlestep durchgehe, springt er beim Aufruf der FPS_discover Methode in NativeLibrary.java -> private String getLibraryName(String libraryName)
Allerdings ist der Code in Netbeans ausgegraut und ich kann nicht in die Variablen reinschauen. Es wird mir nur angezeigt: "... is not a known variable in the current context"
Wie kann ich in die Variablen reinschauen?