嵌入式Java与C混合编程:通过JNI直接调用底层硬件驱动接口
嵌入式Java做业务、联网、UI很顺手,但GPIO、ADC、PWM、私有字符设备仍要C驱动。JNI负责“Java声明→C桥→open/ioctl/read/write→close”,把硬件细节封在so里,Java只留安全、可测试的API。
一、Java侧声明与加载
按功能拆native,不在Java里传复杂对象,用int/byte[]/String降低转换成本:
package com.iot.hal;
public class HwDriver {
static { System.loadLibrary("hwdrv"); } // libshwdrv.so
public native int openDevice(String path);
public native int ioctlInt(int fd, int cmd, int arg);
public native int readBytes(int fd, byte[] buf, int len);
public native void closeDevice(int fd);
}
javac -h自动生成头,避免手写出错:
javac -d out src/com/iot/hal/HwDriver.java
javac -h jni -d out src/com/iot/hal/HwDriver.java
gcc -shared -fPIC -I"$JAVA_HOME/include" -I"$JAVA_HOME/include/linux" \
hwdrv.c -o libhwdrv.so
-fPIC和jni.h路径必须正确,否则JVM加载so会报UnsatisfiedLinkError。
二、C侧调字符设备
以LED/IO控制字符节点为例,open拿到fd,ioctl下命令,read拿状态,最后close。真实cmd用驱动定义的宏,这里用参数化示例:
#include "com_iot_hal_HwDriver.h"
#include <fcntl.h>
#include <unistd.h>
#include <sys/ioctl.h>
JNIEXPORT jint JNICALL Java_com_iot_hal_HwDriver_openDevice
(JNIEnv *env, jobject obj, jstring path){
const char *p=(*env)->GetStringUTFChars(env,path,NULL);
if(!p) return -1;
int fd=open(p,O_RDWR);
(*env)->ReleaseStringUTFChars(env,path,p);
return fd; // 打开失败返回-1,Java层判错
}
JNIEXPORT jint JNICALL Java_com_iot_hal_HwDriver_ioctlInt
(JNIEnv *env, jobject obj, jint fd, jint cmd, jint arg){
if(fd<0) return -1;
return ioctl(fd,cmd,arg); // 具体命令由内核驱动定义
}
JNIEXPORT jint JNICALL Java_com_iot_hal_HwDriver_readBytes
(JNIEnv *env, jobject obj, jint fd, jbyteArray buf, jint len){
if(fd<0||!buf) return -1;
jbyte tmp[256];
int n=read(fd,tmp,len>256?256:len);
if(n>0)(*env)->SetByteArrayRegion(env,buf,0,n,tmp);
return n;
}
JNIEXPORT void JNICALL Java_com_iot_hal_HwDriver_closeDevice
(JNIEnv *env, jobject obj, jint fd){
if(fd>=0) close(fd);
}
open/ioctl/close的JNI骨架与LED驱动调用方式一致,工程里把cmd、errno、设备路径全部参数化。
三、Java调用与异常映射
HwDriver d=new HwDriver();
int fd=d.openDevice("/dev/iot_led0");
if(fd<0) throw new RuntimeException("open driver failed");
try{
d.ioctlInt(fd,0x01,1); // 点灯,cmd按驱动头文件定
byte[] st=new byte[8];
int n=d.readBytes(fd,st,st.length);
} finally { d.closeDevice(fd); }
C返回错误不要只给-1,Java侧按errno包装成IllegalStateException;ioctl参数、fd合法性、缓冲区长度都在Java先校验,再进native,减少C层段错误。
四、嵌入式避坑
权限:/dev节点给root或udev建组,Java进程别用root全程跑;可通过systemd配SupplementaryGroups,so加载路径用绝对System.load防误搜。
内存:GetStringUTFChars/GetByteArrayElements必须配Release;C层malloc的缓冲别直接返Java指针,改拷到jbyteArray/jstring,避免GC无法回收。
线程:JNIEnv不能跨线程传;C创建pthread调Java要先AttachCurrentThread,退出Detach,否则JVM引用泄漏。
性能:高频采样别逐寄存器调一次JNI,改为一次native批量读N个通道、返回byte[]/int[];循环内少建String,用-Xcheck:jni开发期抓越界。
稳定:C段错误会直接拖垮JVM。关键硬件操作加参数边界、fd检查、返回值判断;复杂驱动可把JNI放独立进程通过Unix域socket通信,牺牲一点延迟换故障隔离。
替代:标准C库、libgpiod、串口、OpenSSL等可评估JNA/FFM;但Android/老嵌入式JVM、私有ioctl仍用JNI最稳。
按“Java薄接口+C薄桥+驱动字符节点”分层,GPIO、PWM、ADC、自定义FPGA寄存器均可用同一套JNI模板接入,业务用Java快速迭代,底层性能与实时性仍掌握在C驱动手里。





