This is not a port of druntime! This is a completely new implementation for low-resource environments. Normal D code may not work here!
LWDR is now part of the Symmetry Autumn of Code 2021. The work plan is here.
This is the light weight D runtime - it is a barebones runtime targeting ARM Cortex CPUs. It works by abstracting hooks that the user can connect to their selected backend (be it an RTOS such as FreeRTOS, ChibiOS, etc or a minimalist system).
- Class allocations and deallocations (via
newanddelete) - Struct heap allocations and deallocations (via
newanddelete) - Invariants
- Asserts
- Contract programming
- Basic RTTI (via
TypeInfostubs) - Interfaces
- Static Arrays
- Virtual functions and overrides
- Abstract classes
- Static classes
- Allocation and deallocation of dynamic arrays (opt in by version
LWDR_DynamicArray) - Concatenate an item to a dynamic array (opt in by version
LWDR_DynamicArray) - Concatenate two dynamic arrays together (opt in by version
LWDR_DynamicArray) - Dynamic array resizing (opt in by version
LWDR_DynamicArray) - Thread local storage (opt in by version
LWDR_TLS) - Delegates/closures (opt-in by version
LWDR_ManualDelegate) - Module constructors and destructors (opt-in by version
LWDR_ModuleCtors) - Static constructors and destructors (opt-in by version
LWDR_ModuleCtors) - Shared static constructors and destructor (opt-in by version
LWDR_ModuleCtors) - Module info (opt-in by version
LWDR_ModuleCtors) - Object monitors (opt in by version
LWDR_Sync) - Shared and sychronized (opt in by version
LWDR_Sync)
- Exceptions and Throwables (experimental implementation was removed)
- There is no GC implementation (primitive memory tracking is now available with
LWDR_TrackMem,RefCount!TandUnique!Tare now available) - Associative arrays
LDC works the best. DMD is not compatible. GDC will work but points 18-21 inclusive aren't supported.
Yes, as of currently it has been run on an STM32F407.
You have to hook the functions declared in rtoslink.d by implementing them in your MCU development environment. For example, with FreeRTOS, rtosbackend_heapalloc points to a wrapper in the C/C++ land that wraps pvPortMalloc(...).
First off, you will need an existing C/C++ project for your target microcontroller that has a C compiler and link, and has some form of memory management (RTOS preferred). The C/C++ code can then call into your D functions (they must be marked extern(C)).
LWDR can be used with DUB and LDC. Simply add it to your dependencies. Build instructions are here for DUB and LDC.
This will output a lib archive that you can link into your C/C++ project and execute on an MCU.
Here is an example code using FreeRTOS:
//myapp.d
module myapp;
import lwdr;
class Foo
{
this()
{
// do something
}
void bar()
{
// do something
}
}
extern(C) void myDFunction()
{
Foo foo = new Foo; // this will invoke rtosbackend_heapalloc(..)
foo.bar;
LWDR.free(foo); // don't forget to free - there is no GC
// LWDR.free will invoke rtosbackend_heapfreealloc(..)
}// main.h
#ifndef __MAIN_H
#define __MAIN_H
#ifdef __cplusplus
extern "C" {
#endif
// defined in rtoslink.d
void* rtosbackend_heapalloc(unsigned int sz);
void rtosbackend_heapfreealloc(void* ptr);
void rtosbackend_arrayBoundFailure(char* file, unsigned int line);
void rtosbackend_assert(char* file, unsigned int line);
void rtosbackend_assertmsg(char* msg, char* file, unsigned int line);
void myDFunction(); // defined in myapp.d
#ifdef __cplusplus
}
#endif
#endif __MAIN_H// main.cpp
#include "cmsis_os.h"
void* rtosbackend_heapalloc(unsigned int sz) // defined in rtoslink.d
{
return pvPortMalloc(sz); // allocate some heap memory for D
}
void rtosbackend_heapfreealloc(void* ptr)// defined in rtoslink.d
{
vPortFree(ptr); // deallocate some heap memory for D
}
void rtosbackend_arrayBoundFailure(char* file, unsigned int line)
{}
void rtosbackend_assert(char* file, unsigned int line)
{}
void rtosbackend_assertmsg(char* msg, char* file, unsigned int line)
{}
osThreadId_t defaultTaskHandle; // thread handle
osThreadAttr_t defaultTask_attributes; // thread attributes
void myTask(void *argument)
{
myDFunction();
}
int main()
{
osKernelInitialize();
defaultTask_attributes.name = "defaultTask";
defaultTask_attributes.priority = (osPriority_t) osPriorityNormal;
defaultTask_attributes .stack_size = 128 * 4;
// create a thread that executes myTask
defaultTaskHandle = osThreadNew(myTask, NULL, &defaultTask_attributes);
osKernelStart(); // start the scheduler
while(1) {}
return 1;
}GDB will be able to set breakpoints in D code and perform steps normally.
Credit to Adam D. Ruppe for his webassembly project that forms the basis of this project.
Credit to D Language Foundation for its D runtime.
Credit to LDC Developers for its D runtime.
Credit to GDC for its D runtime.
Credit to denizzka for his d_c_arm_test which helped with the implementation of TLS (thread local storage).
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent