Dpdl (Dynamic Packet Definition Language)

Dpdl is a rapid development programming language and constrained device framework with built-in database technology.

The Dpdl language constructs and syntax is simple and intuitive, yet powerful, with an object oriented paradigm (OOP), interoperable with java JVM platform APIs and external Native shared libraries.

Dpdl comes as a very compact and portable execution engine (DpdlEngine) with an extensible API interface that enables to execute Dpdl code, as well as code in other programming languages or any custom syntax directly embedded within the same Dpdl source code, simultaneously and of multiple types.

Dpdl provides access to java platform API’s, Native shared libraries, Wasm modules and GPU compute and enables the embedding and execution of multiple programming languages like C, C++, Python & MicroPython, Julia, JavaScript, Lua, Ruby, Java, PHP, Perl, Groovy,V, Clojure, Modelica, Wgsl and OpenCL, directly embedded within Dpdl code. Everything comes already included with the DpdlEngine, No additional installations required.

The core Dpdl engine has the capability to run also on memory constrained devices and platforms via a dedicated kilobyte range virtual machine.

Dpdl is Self contained, Compact, Portable and Highly customizable

Dpdl + ( Java Api’s + C + ‘C++’ + Python + Julia + JavaScript + Java + Lua + Ruby + PHP + Perl + Groovy + V + Clojure + Wat/Wasm + Wgsl + OpenCL + Modelica + AI) = Powerful and Versatile

Dpdl itself is a multi-purpose programming language, self-contained, interpreted and in part also dynamically bytecode compiled, statically as well as dynamically typed, with a very compact memory footprint and portable to most platforms. There is an on-going development to enable Dpdl code to be compiled also directly to native code for multiple target platforms.

In addition Dpdl introduces the concept of embedded code sections that can be executed within Dpdl code. It allows to create and integrate custom syntax and language interpreters of all sorts in form of ‘Dpdl language plug-ins’, for example code in other programming languages.

Multiple ‘Dpdl language plug-ins’ are currently available, for example the ‘Modelica’ language for cyber-physical simulations is also available as ‘Dpdl language plug-in’. Further Dpdl language plug-ins are currently in active development, for example to enable also Quantum Computing directly inside Dpdl via embedded OpenQWASM code.

The included Dpdl language plug-in ‘DpdlAINerd’ (DAN) enables to automatically generate via AI generative code programming language code and content or data, embed it automatically within Dpdl code and execute the code right away. Alternatively the generated code can also be rewritten to a new file and executed in a subsequent step.

Further, the custom ‘DpdlPacket’ data container with built-in database technology provides a convenient way to package, handle and query data efficiently on memory scarce devices.

Dpdl is designed to:

DpdlEngine stack overview

Compact, Robust, Extensible and Portable to almost every platform

Common IoT protocol stacks such as Bluetooth™ and CoAP (Constrained Application Protocol) are integrated by default and third party libraries and protocols can be added as extensions.

Dpdl provides a simple access to java API’s, Native shared libraries, Wasm modules and GPU compute.

The included Dpdl language plug-in ‘DpdlAINerd’ (DAN) enables to make use of AI generative code to automatically generate and embed executable code and content or data by means of natural language descriptions contained inside Dpdl code.

Further, Dpdl can be used to encode, store, control and query data efficiently also on small memory footprint devices via a custom data container defined as ‘DpdlPacket’.

Dpdl enables the integration of different technologies to leverage fast prototyping and foster research and development.

Dpdl can be used as:

Features

For more Info visit the official Dpdl-io repository on GitHub:
DpdlEngine

Prototype sample applications implemented with Dpdl can be found on this GitHub repository:
Dpdl-sample-Apps

Dpdl JVM/JRE access

Dpdl provides API functions to load and access java objects and methods of the underlying java JVM JRE platform and of any other external java libraries. This allows to use a broad set of API’s within Dpdl.

Dpdl Example using external Java libraries

This is a sample Dpdl app implementing a 3D model visualization of chemical molecules using the JavaFX library. The model can be rotated freely with mouse events.

graphics/dpdl3DJavaFX_molecule.h

VIDEO of Dpdl sample 3D application

Dpdl language plug-ins (dpdl embeddable code)

Multiple programming languages can be embedded and executed within the same Dpdl code via the keyword >>.

Further programming languages and syntax interpreters can be developed and integrated via a dedicated plug-in interface and configuration if form of Dpdl language plug-ins.

This enables basically every sort of programming language or natural language syntax interpreter to be embedded and executed directly within Dpdl code.

This features is very useful for rapid development and rapid prototyping and is also a key feature for generative code.

Currently the following programming languages can be embedded within Dpdl:

available add-on ‘Dpdl language plug-ins’:

In development ‘Dpdl language plug-ins’ (available soon in coming releases):

Dpdl Example with embedded ‘C’ and ‘JavaScript’ code

Sample Dpdl code with embedded ‘C’ code and javascript:

struct  A  {
	string id = "A"
	int  x = 10
	float f = 0.3
	double d = 0.4d
	object stro = loadObj("String",  "This is a java.lang.String object")

	func print()
		println("------------------")
		println("id: "  + id)
	end
}

# main
println("With Dpdl you can make use of any java library and embed different programming languages...")

struct A mya
mya.print()

println("creating a hashmap to store key/value pairs...")

object mymap = loadObj("HashMap")
mymap.put(1,  "Dpdl")
mymap.put(2,  "is")
mymap.put(3,  "Simple")
mymap.put(4,  "Compact")
mymap.put(5,  "Portable")

object keys = mymap.keySet()
object iter = keys.iterator()
object key, value
for(iter.hasNext())
	key = iter.next()
	value = mymap.get(key)
	println("key: "  + key +  " value: "  + value)
endfor

bool bcon = mymap.containsValue("Dpdl")
println("mymap contains 'Dpdl': "  + bcon)
println("")

println("Embed different programming languages directly..")
println("")

int n = 6
double x = 10.0d
string a = "test"
println("embedding C...")

dpdl_stack_push("dpdlbuf_var1",n, x, a)
>>c
#include <stdio.h>
#include <dpdl.h>

int dpdl_main(int argc,  char  **argv){
	printf("Hello C from Dpdl!\n");
	printf("\n");
	printf("num  params: %d\n", argc);
	int cnt;
	for (cnt =  0; cnt < argc; cnt++){
		printf(" param %d: %s\n", cnt, argv[cnt]);
	}
	char *buf = "My result";
	dpdl_stack_buf_put(buf);
	return  0;
}
<<
int exit_code = dpdl_exit_code()
println("embedded C exit code: "  + exit_code);
string buf = dpdl_stack_buf_get("dpdlbuf_var1")
println("response buffer: "  + buf)
println("")

println("embedding javascript...")
int val = 23
arr[] = [1, 2, 3, 4]

dpdl_stack_push(val, arr)
>>js
console.log('Dpdl sends a message with js');
var sa;
var arr;
var v;
if(scriptArgs.length > 1){
	v = scriptArgs[0];
	sa = scriptArgs[1];
	arr = sa.split(",");
	std.printf("val=%d\n", v);
	console.log(arr);
}else{
	sa = "";
}

for(let i = 0; i < arr.length; i++)  {
	std.printf("arr[%d]=%d\n", i, arr[i]);
}
<<
int js_exit_code = dpdl_exit_code()
println("embedded javascript exit code: "  + js_exit_code);

Supported Platforms

Dpdl runs on a wide range of platforms and includes also a small footprint kilobyte range java virtual machine that can be compiled for almost every platform as soon as an ANSI C compiler is available for the target platform.

‘DpdlEngine’ is compatible with:

So far DpdlEngine V1.0 has been tested on:

Roadmap

Dpdl is currently developed by SEE Solutions and the following integrations are in development:

Docs

The Dpdl framework and API documentation are available via the following links:

Dpdl Documentation

Dpdl API Documentation

Dpdl language plug-ins

Dpdl embedded minimal C library Documentation

Dpdl compiler documentation

Dpdl Native Interface

Dpdl GPU Compute

Dpdl Wasm runtime

DpdlClient

DpdlPacket

DpdlAINerd

More…

Dpdl Examples

Dpdl HowTo’s

Dpdl Tutorials

Visit also the official Dpdl-io repository on GitHub for updates: DpdlEngine

Dpdl Examples

Dpdl-sample-Apps

Full featured applications developed with Dpdl are published on this GitHub repository:

Dpdl-sample-Apps

Dpdl example with embedded ‘C++’ code that make use of the ROOT framework libraries

ROOT is a powerful Data Analysis Framework developed by CERN (https://root.cern/) .

ROOT C++ code can be embedded within Dpdl via the keyord ‘>>root’

Example Dpdl code embedding C++ with libs ‘ROOT’:
Dpdl ROOT example

# main
println("test embedded ROOT C++...")

>>root
auto canvas = new TCanvas("c","Graph2D example",0,0,700,600);

double x, y, z, P = 6.;
int np = 200;
auto dt = new TGraph2D();
auto r = new TRandom();
for (int N=0; N<np; N++) {
	x = 2*P*(r->Rndm(N))-P;
	y = 2*P*(r->Rndm(N))-P;
	z = (sin(x)/x)*(sin(y)/y)+0.2;
	dt->SetPoint(N,x,y,z);
}
dt->Draw("tri1 p0");
canvas->Modified(); canvas->Update();
<<

int exit_code = dpdl_exit_code()
println("embedded ROOT exit code: " + exit_code)

Sample Dpdl code that make use of type ‘class’ Inheritance and Polymorphism and make use of some embedded code section in other programming languages

The following simple Dpdl example shows how the type class can make use of Inheritance and Polymorphism. Some functions in this example make use of embedded code sections implemented in ‘Java’ and ‘C’

struct  property  {
	int  max_weight_gr
	float  max_height_m
	string desc  = null
}

class  Animal  {
	int  id
	string name
	struct property info =  {100000,  2.5,.}

	func Animal(int  id_)
		id = id_
		name =  "No name"
		
		println("new Animal() with id: "  + id +  " info: "  + info)
	end
	
	func Animal(int id_, string name_)
		id = id_
		name = name_
		
		println("new Animal with id: "  + id +  " and name: "  + name +  " - info: "  + info)
	end

	func print()
		println("This is an Animal")
	end
	
	func makeSound()
		println("kind of animal is not defined")
	end

	func getHashMap()
		object h_map = loadObj("HashMap")
		
		info_arr[]  = array(info)
		int i =  0
		for(i < info_arr.size())
			h_map.put(i, info_arr[i])
			i=i+1
		endfor
		
		return h_map
	end
}

class  Dog  :  Animal  {
	func Dog(int  id_, string name_)
		super(id_, name_)
		
		info.max_weight_gr =  8000
		info.max_height_m =  0.5
		info.desc =  "this breed is Shitzu"

		println("new Dog() with id: "  + id +  " and name: "  + name +  " - info: "  + info)
	end

	func print()
		println("This is a Dog with name: "  + name)
	end

	func makeSound()
		println("WOOF WOOF")
	end

	func makeSound(int times)  int
		int ret_val
		
		dpdl_stack_push(times)
		
		>>java
		int iter = arg0.intValue();
		
		for(int i =  0; i < iter; i++){
			System.out.println("WOOF");
		}
		return  1;
		<<
		ret_val = dpdl_exit_code()
		
		return ret_val
	end
}

class  Cat  :  Animal  {

	func Cat(int  id_, string name_)
		super(id_, name_)

		info.max_weight_gr =  1000
		info.max_height_m =  0.25
		info.desc =  "thie breed is Siamese"

		println("new Cat() with id: "  + id +  " and name: "  + name +  " - info: "  + info)
	end

	func print()
		println("This is a Cat with name: "  + name)
	end

	func makeSound()
		println("MIAUU MIAUU")
	end

	func makeSound(int beep)  int
		int ret_val

		dpdl_stack_obj_put("iter", beep)

		dpdl_stack_push("dpdl:applyvars")
		>>c
		#include  <stdio.h>
		#include  <unistd.h>

		// we output the character to ring 'bell' in the console
		for(int i =  0; i <  {{iter}}; i++){
			putchar('\a');
		}
		return  23;
		<<
		ret_val = dpdl_exit_code()

		return ret_val
	end
}

# main
println("testing class type Inheritance and Polymorphism...")
println("")

class Animal ani(1)

ani.print()
ani.makeSound()

println("")

class Dog mydog(2,  "Rosa")

mydog.print()
mydog.makeSound()
int sd = mydog.makeSound(100)

object map_dog = mydog.getHashMap()
println("map dog: "  + map_dog)

println("")

class Cat mycat(3,  "Minni")

mycat.print()
mycat.makeSound()
int sc = mycat.makeSound(3)

object map_cat = mycat.getHashMap()
println("map cat: "  + map_cat)

println("")
println("finished")

Compress and decompress data using the Java JRE Platform API

Dpdl example that uses java.util.GZIP* classes to compress and de-compress data

# main
object str = loadObj("String", "my data to compress")
println("string to compress: " + str)

object byte_out = loadObj("ByteArrayOutputStream")
object zip_out = loadObj("GZIPOutputStream", byte_out)

println("compressing...")
zip_out.write(str.getBytes("UTF-8"))
zip_out.close()
println("data compressed successfully!")

object compressed_str = byte_out.toString()
println("compressed string: " + compressed_str)

println("decompressing...")
object byte_in = compressed_str.getBytes("UTF-8")
object byte_arr_in = loadObj("ByteArrayInputStream", byte_in)
object byte_arr_in_obj = cast(byte_arr_in)
object zip_in = loadObj("GZIPInputStream", byte_arr_in_obj)

object in_reader = loadObj("InputStreamReader", zip_in)
object buf_reader = loadObj("BufferedReader", in_reader)

string decompressed_str = ""
string line = ""
while(line != null)
	line = buf_reader.readLine()
	if(line != null)
		decompressed_str = decompressed_str + line
	fi
endwhile

println("decompressed: " + decompressed_str)

Bluetooth device discovery

Example Dpdl code that performs Bluetooth device discovery using high level Dpdl BT API :

int status = DPDLAPI_searchClientsOnServer()
int status_discovery = dpdlFalse
int service_discovery = dpdlFalse
int counter = 0
if(status == dpdlTrue)
	while (status_discovery != dpdlTrue) && (service_discovery != dpdlTrue)
		status_discovery = DPDLAPI_discoveryServerFinished()
		service_discovery = DPDLAPI_serviceDiscoveryServerFinished()
		print(".")
		counter = counter+1	
		sleep(3000)
	endwhile
	
	string dev = "n"
	int dev_found = 0
	while(dev != "null")
		dev = DPDLAPI_getServerVisibleBTAddr()
		if(dev != "null")
			println("bluetooth device visible: " + dev)
			saveData(dev)
			dev_found = dev_found + 1
		fi
	endwhile
else
	println("No working Bluetooth stack found")
fi

Embedding of Python code

Python code can be embedded within Dpdl script by using the keyword ‘>>python’.

Example Dpdl script with embedded ‘Python’ code:

println("testing embedding python code wihin Dpdl")
println("")

>>python
languages = ['Dpdl', 'C', 'Python', 'OCaml']
for language in languages:
	print(language)
<<
# again Dpdl
println("")
int exit_code = dpdl_exit_code()
println("ebedded python exit code: " + exit_code);

Embedding C code

Dpdl allows the embedding and on-the-fly compilation and execution of C code directly within Dpdl scripts.

The C code can be embedded and executed with 2 distinct Modes, either interpreted only OR compiled and executed in memory at runtime.

The two modes have distinct properties: The interpreted C code execution is for example more convenient for testing, small footprint and portability, while the compiled C code execution is more convenient for faster execution and for linking with external libraries. The execution of C code is driven by a native Dpdl library that has a small footprint and for the interpreted mode it includes all essential C libraries and language constructs (ISO standard C90), POSIX compliant) with no external library dependencies needed. Custom libraries and functions can be integrated and linked via a straight forward implementation configuration approach.

Example Dpdl script with embedded C code (interpreted):

# main
# starting with Dpdl, pushing parameters on the stack and embedding C code

println("testing embedded C code in Dpdl")
int n = 6
double x = 10.0
string a = "test"
dpdl_stack_push(n, x, a)
>>c
#include <stdio.h>

int dpdl_main(int argc, char **argv){
	printf("Hello C from Dpdl!\n");
	printf("\n");
	printf("num params: %d\n", argc);
	int cnt;
	for (cnt = 0; cnt < argc; cnt++){
		printf(" param %d: %s\n", cnt, argv[cnt]);
	}
	return 0;
}
<<
# again Dpdl...
int exit_code = dpdl_exit_code()
println("embedded C exit code: " + exit_code);

object str = loadObj("String", "Dpdl embedded C")
bool b = str.contains("C")
println("Dpdl contains C: " + b)

This is a more complete example of the usage of embedded C code within Dpdl:

dpdlEmbeddedC.h

Embedding of ‘Julia’

Julia is a powerful and performant computational programming language (https://julialang.org)

Julia code can be embedded within Dpdl via the keyord ‘>>julia’

Example Dpdl script embedding ‘Julia’ that generates a Plot and saves it as PDF:

Dpdl ROOT example

#main
println("Testing Plot data with Julia programming language...")

>>julia
using Plots

x = range(0, 10, length=100)
y1 = sin.(x)
y2 = cos.(x)
p = plot(x, [y1 y2])

savefig(p, "./Test/myplot.pdf")

dispose_status = @ccall dpdl_julia_dispose()::Int32
return 1
<<

int exit_code = dpdl_exit_code()
println("finished with exit code: " + exit_code)

Other programming languages

Other programming languages or natural language interpreters can be easily integrated in Dpdl via a dedicated plug-in interface and configuration in form of ‘Dpdl language plug-ins’. Please feel free to suggest yours favorite language on the Discussion section on the DpdlEngine GitHub repository

More Examples

Dpdl_Examples.md

Request free trial ‘DpdlEngine lite’

The ‘DpdlEngine lite’ release can be requested as Free trial shareware (with some limitation/restrictions) at the following request form:

Download Request Form

The ‘DpdlEngine pro’ instead is available with custom licensing models only.

How to buy a ‘full’ DpdlEngine license?

To buy a full featured ‘DpdlEngine lite’ license with no limitations/restrictions, regular updates and support, please submit your request via the following request form:

Order Request Form

For custom requirements or a bulk reseller license write an e-mail to the contact address.

Contact

e-mail: info@dpdl.io