About Me
Michael Zucchi
B.E. (Comp. Sys. Eng.)
also known as Zed
to his mates & enemies!
< notzed at gmail >
< fosstodon.org/@notzed >
More thoughts on the software code cache
So I veered off on another tangent ... just how to implement the software instruction cache from the previous post.
Came up with a few 'interesting' preliminary ideas although it definitely needs more work.
function linkage table
Each function call is mapped to a function linkage table. This is a 16-byte record which contains some code and data:
;; assembly format, some d* macros define the offset of the given type
dstruct
dint32 flt_move ; the move instruction
dint32 flt_branch ; the branch instruction
dint16 flt_section ; section address (or index?)
dint16 flt_offset ; instruction offset
dint16 flt_reserved0 ; padding
dint16 flt_next ; list of records in this section
dend flt_sizeof
The move instruction loads the index of the function itself into scratch register r12 and then either branches to a function which loads the section that contains the code, or a function which handles the function call itself. The runtime manages this. Unfortunately due to nesting it can't just invoke the target function directly. The data is needed to implement the functionality.
section table
The section table is also 16 bytes long and keeps track of the current base address of the section
dstruct
dint16 sc_base ; loaded base address or ~0 if not loaded
dint16 sc_flt ; function list for this section
dint16 sc_size ; code size
dint16 sc_reserved0
dint16 sc_next ; LRU list
dint16 sc_prev
dint32 sc_code ; global code location
dend sc_sizeof
section header
To avoid the need of an auxiliary sort required at garbage collection time, the sections loaded into memory also have a small header of 8 bytes (for alignment).
dstruct
dint32 sh_section ; the section record this belongs to
dint32 sh_size ; the size of the whole section + data
dend sh_sizeof
Function calls, hit
If the section is loaded ("cache hit") flt_branch points to a function which bounces to the actual function call and more importantly makes sure the calling function is loaded in memory before returning to it, which is the tricky bit.
Approximate algorithm:
rsp = return stack pointer
ssp = section pointer
docall(function, lr)
; save return address and current section
rsp.push((lr-ssp.sc_base));
rsp.push(ssp);
; get section and calc entry point
ssp = function.flt_section
entry = ssp.sc_base + function.flt_offset
; set rebound handler
lr = docall_return
; call function
goto entry
docall_return()
; restore ssp
ssp = rsp.pull();
; if still here, return to it (possibly different location)
if (ssp.sc_base) {
lr = rsp.pull() + ssp.sc_base;
goto lr;
}
; must load in section
load_section(ssp)
; return to it
lr = rsp.pull() + ssp.sc_base;
goto lr;
I think I have everything there. It's fairly straightforward if a little involved.
If the section is the same it could avoid most of the work but the linker wont generate such code unless the code uses function pointers. The function loaded by the stub (flt record) might just be an id (support 65K functions) or an address (i.e. all on-core functions).
I have a preliminary shot at it which adds about 22 cycles to each cross-section function call in the case the section is present.
Function calls, miss
If the section for the function is not loaded, then the branch will instead point to a stub which loads the section first before basically invoking docall() itself.
doload(function, lr)
; save return address and current section
rsp.push((lr-ssp));
rsp.push(ssp);
; load in section
ssp = function.flt_section
load_section(ssp);
; calculate function entry
entry = ssp.sc_base + function.flt_offset
; set rebound handler (same)
lr = docall_return
; call function
goto entry
load_section() is where the fun starts.
Cache management
So I thought of a couple of ways to manage the cache but settled on a solution which uses garbage collection and movable objects. This ensures every byte possible is available for function use and i'm pretty certain will take less code to implement.
This is where the sh struct comes in to play - the cache needs both an LRU ordered list and a memory-location ordered list and this is the easiest way to implement it.
Anyway i've written up a bit of C to test the idea and i'm pretty sure it's sound. It's fairly long but each step is simple. I'm using AmigOS/exec linked lists as they('re cool and) fit this type of problem well.
loader_ctx {
list loaded;
list unloaded;
int alloc;
int limit;
void *code;
} ctx;
load_section(ssp) {
needed = ctx.limit - ssp.sc_size - sizeof(sh);
if (ctx.alloc > needed) {
; not enough room - garbage collect based on LRU order
; scan LRU ordered list for sections which still fit
used = 0;
wnode = ctx.loaded.head;
nnode = wnode.next;
while (nnode) {
nused = wnode.sc_size + used + sizeof(sh);
if (nused > needed)
break;
used = nused;
wnode = nnode;
nnode = nnode.next;
}
; mark the rest as removed
while (nnode) {
wnode.sc_base = -1;
;; fix all entry points to "doload"
unload_functions(wnode.sc_flt);
wnode.remove();
ctx.unloaded.addhead(wnode);
wnode = nnode;
nnode = nnode.next;
}
; compact anything left, in address order
src = 0;
dst = 0;
while (dst < used) {
sh = ctx.code + src;
wnode = sh.sh_section;
size = sh.sh_size;
; has been expunged, skip it
if (wnode.sc_base == -1) {
src += size;
continue;
}
; move if necessary
if (src != dst) {
memmove(ctx.code + dst, ctx.code + src, size);
wnode.sc_base = dst + sizeof(sh);
}
src += size;
dst += size;
}
}
; load in new section
;; create section header
sh = ctx.code + ctx.alloc;
sh.sh_section = ssp;
sh.sh_size = ssp.size + sizeof(sh);
;; allocate section memory
ssp.sc_base = ctx.alloc + sizeof(sh);
ctx.alloc += ssp.size + sizeof(sh);
;; copy in code from global shared memory
memcpy(ssp.sc_base, ssp.sc_code, ssp.sc_size);
;; fix all entry points to "docall"
load_functions(ssp.sc_flt);
;; move to loaded list
ssp.remove();
ctx.loaded.addhead(ssp);
}
The last couple of lines could also be used at each function call to ensure the section LRU list is correct, which is probably worth the extra overhead. Because the LRU order is only used to decide what to expunge and the memory order is used for packing it doesn't seem to need to move functions very often - which is obviously desirable. It might look like a lot of code but considering this is all that is required in totality it isn't that much.
The functions load_functions() and unload_functions() just set a synthesised branch instruction in the function stubs as appropriate.
Worth it?
Dunno and It's quite a lot of work to try it out - all the code above basically needs to be in assembly language for various reasons. And the loader needs to create all the data-structures needed as well, which is the flt table, the section table, and the section blocks themselves. And ... there needs to be some more relocation stuff done if the sections use relative relocs (i.e. -mshort-calls) when they are loaded or moved - not that this is particularly onerous mind you.
AmigaOS exec Lists
The basic list operations for an exec list are always efficient but turn out to be particularly compact in epiphany code, if the object is guaranteed to be 8-byte aligned which it should be due to the abi.
For example, node.remove() is only 3 instructions:
; r0 = node pointer
ldrd r2,[r0] ; n.next, n.prev
str r2,[r3] ; n.prev.next = n.next
str r3,[r2,#1] ; n.next.prev = n.prev
The good thing about exec lists is that they don't need the list header to remove a node due to some (possibly) modern-c-breaking address-aliasing tricks, but asm has no such problems.
list.addTail() is only 4 instructions if you choose your registers wisely (5 otherwise).
; r3 = list pointer
; r0 = node pointer
ldr r2,[r3] ; l.head
strd r2,[r0] ; n.next = l.head, n.prev = &l.head
str r0,[r2,#1] ; l.head.prev = n
str r0,[r3] ; l.head = n
By design, &l.head == l.
Unfortunately the list iteration trick of going through d0 loads (which set the cc codes directly) on m68K doesn't translate quite as nicely, but it's still better than using a container list and still only uses 2 registers for the loop:
; iterate whole list
; r2 = list header
ldr r0,[r2] ; wnhead (work node)
ldr r1,[r0] ; nn = wn.next (next node)
sub r1,r1,0 ; while (nn) {
beq 2f
1:
; r0 is node pointer and free to be removed from list/reused
; node pointer is also ones 'data' so doesn't need an additional de-reference
mov r0,r1 ; wn = nn
ldr r1,[r1] ; nn = nn.next
sub r1,r1,0
bne 1b
2:
Again the implementation has a hidden bonus in that the working node can be removed and moved to another list or freed without changing the loop construct or requiring additional registers.
For comparison, the same operation using m68K (devpac syntax might be out, been 20 years):
; a0 = list pointer
mov.l (a0),a1 ; wn = l.head (work node)
mov.l (a1),d0 ; nn = wn.next (next node)
beq.s 2f ; while (nn) {
.loop:
; a1 is node pointer, free to be removed from list/reused
mov.l d0,a1 ; wn = nn
mov.l (a1),d0 ; nn = wn.next
bne.s .loop
2:
See lists.c from puppybits for a C implementation.
software instruction cache
So I was posting on the parallella forums and had an idea for something to investigate in the future.
Basically have the ezesdk loader create an automatic software code cache based on sections.
The thinking is this:
- The relocatable elf files contain RELOC hunks for all function calls outside of the current section (and inside if they are not compiled with -mshort-calls);
- These need to be resolved by the loader anyway;
- The loader could point these anywhere - including to a global relocation table which included loader-generated entries;
- The global relocation table could call a stub which loads the code anywhere in memory because the code is now relocatable (since every function call goes via the stubs).
Well, it's a little more complex than that because return addresses from the stack also need to make sure they track the current location of the caller and if it needs to be re-loaded into the cache. Still off the top of my head, ... this may be possible. For example each stub could track the current callee module in a separate return stack which can be updated should any section be unloaded or relocated. Interrupts would need special handling.
Idea needs to stew.
I haven't had the energy to do much but a 0.0 release of 'ezesdk' isn't too far off. I did the license headers, updated the readme from elf-loader, and tweaked the makefiles a few times. Still playing with some of the apis too.
On liver n stuff n shit.
So one of those things you never really liked as a kid. Once in a while I think 'man i could go some liver', even mum's cooked-to-hell-and-back version that just turns each sliver into a piece of copper-tainted rubber. I have some lamb's fry in the fridge so that might be (part of) dinner tonight. It's usually kind of 'yeah did that, not sure why' but you know, it has to be done sometimes.
Made some lime cordial today, had a couple of g&t's while i was bringing it to the boil and continued thereafter. Went with the straight ABC recipe (hmm, seems the original page is gone) this time even with it's 1.5Kg of sugar although I added a lot more citric acid - love me a good bit of tart and it's better to be safe than sorry on the preservation side of things. The last few batches didn't have enough punch and i've been thinking it might be due to a lack of sugar so this is part of the experiment to confirm that hypothesis. I had to buy the limes this time :( but they were cheap because they were old, and they've been in the fridge for weeks - but they still have a nice sweet ripe taste so i'm hopeful of a good batch. I usually make my own 'soda' with it: 500ml glass of really cold water + ice, some cordial 'to taste', 3/4 teaspoon of citric acid and 3/4 teaspoon of bi-carb, stir till it fizzes then slam it down; a really fast (and tasty) way to re-hydrate after an afternoon in the sun. Doesn't work if the water isn't super-cold - it just fizzes over and goes flat.
Trying not to think of the week ahead. The 200km of cycling I did last week at least shaved a couple of kilo's off my spare tyre and turned my legs into iron but i'm still recovering after 3 days rest - wildly out of practice and alas not 20 any-more. At least it's a short week coming up with Easter next weekend. The biltong I made last week is just about ready - taking a while to dry in this weather and I didn't find the 40W incandescent 'heater' till a couple of days ago (normal globes around here don't produce enough heat anymore, this is a narrow candle flame shaped one which still has a tungsten filament). Forgot to dip it in vinegar and the spice mix might have a touch too much fennel but it's still pretty tasty, i'll jot down the recipe on here in another post in the not too distant future. Made it straight from some corned silverside which was on special, so it both cheap and easy to make.
End of intermission ... back to the g&t's ... and maybe some liver if i can be bothered ...
the eze-thing
After the last week I felt the need for a bit of coding ... i worked a bit on the eze-library, deciding on a directory structure and using it, filling out some missing bits and working on the build system. I learnt a few make and gcc things along the way - which is always nice.
I included and/or implemented the various bits and pieces of mentioned on the last few parallella related posts - things like the global loader-defined barrier memory, async dma (via a queue and interrupts), and the startup routine that can pass arguments to kernels, track the current running state and set a return code.
I decided to just allocate the barrier memory for the whole workgroup before the code address every time even if barriers aren't being used. It can always be changed. Still yet to test the implementation.
The start of the memory-map (excluding the isv entries) now looks like this:
+----------+------
| 0028 | extmem
| 002c | group_id
| 0030 | group_rows
| 0034 | group_cols
| 0038 | core_row
| 003c | core_col
| 0040 | group_size
| 0044 | core_index
+----------+------
| 0048 | imask (short, but here so it can be loaded as int)
| 004a | status (short)
| 004c | exit code
| 0050 | entry
| 0054 | sp
| 0058 | arg0
| 005c | arg1
| 0060 | arg2
| 0064 | arg3
+----------+------
| 0068 | barrier, group_size bytes
| |
+----------+------
| ≥006c | .text .data .bss
| | .text.bank0 .data.bank0 .bss.bank0
Not sure if it'll work but i experimented with a @workgroup "tag" on section names. If present the allocation is multiplied by the workgroup size - this was whilst working on the barrier stuff before I realised that wont work because the barrier location has to be the same across all work-items in the work-group even if they're running separately linked code. Something I can play with later anyway.
After getting the most basic test running i'm to the point of being able to debug the new features. And I just got the async dma interfaces to function (yay?) before writing this up. Actually it works out pretty nicely. I define the async dma queue inside the isr handler code so that by using the c functions which reference the queue it drags in the isr and isr vector automatically, which the loader tracks so that the new sync isr automagically sets the correct imask too.
Once i've got everything going i've got a bit of housekeeping stuff to deal with before it can go further. But for now I've settled on two libraries:
-
libezehost.so
-
The host-side library (surprise). This includes a fork of the adapteva esdk 'e-hal' as well as the elf-loader stuff. The on-core runtime interface has been changed to accommodate the new features so it wont work with pre-linked binaries.
-
libezecore.a
-
This is the on-core support library and equivalent to e-lib. Most of the functions are inline calls which generates smaller code-size and more efficient compilation of leaf functions.
I have assembly versions of almost every non-inline routine too; they save some code-space but maybe not enough to be worth it. I might include it as another library option. Perhaps.
I'm probably also going to look at different runtime mechanisms such as a "job queue" mode rather than the current "one shot" mode. This will be changed by specifying a different crt0.o file. Already the crt0 implementation I have allows one to restart the core by just using e_start() without requiring a reset first because the exit routine just idles rather than trapping.
developer tools and tasks vs non-developer tools and tasks
So I started on a project that uses maven for it's build / test and deploy 'script'. Or some part of it; it's complicated.
Like ant (or maybe worse), maven doesn't seem to do dependency checking on targets. All it does is build a dependency graph of the tasks and executes them in an order which satisfies that graph. Or if it fails mid-build you can add some command line arguments to continue from a specific place. Or you can manually cd to a specific part of the system and build that in isolation - but that's one-way ticket to fragility and is error prone even if you've got a really good idea of how the project fits together. So basically you're forced to recompile the whole shooting match every time even if nothing changed in most of the application. This is probably a direct result of both ant and maven's design as a task-based dependency tree rather than a goal based one.
Whilst talking to someone about how useless maven is they mentioned it sounded more like tool more suited to qa or production builds.
Which makes a lot of sense to me.
A developer needs:
- Fast;
- Simple;
- Reliable;
- Repeatable;
- Robust.
But for configuration management for QA builds or production, the operator only needs:
- Reliable;
- Repeatable;
- Robust.
Whilst there is considerable overlap there doesn't seem to be enough to me to justify the overhead in developer time - unless you're paying them peanuts having them wait Dx10xN minutes for D developers to re-build stuff that has already been built every time becomes an incredibly costly exercise.
I think this is similar to my main problem with git. Git was written by a configuration/qa manager (Linus), not a typical developer. His needs are that of a configuration/qa manager and not a typical developer. Apart from having an offensive name, it forces every developer to become their own configuration manager as well and whilst that might be a lofty goal it's taking away time from actually getting work done too. This costs money.
What's remotely agile about Agile?
They also use some sort of 'agile' team management process. I really can't say anything good about that at all.
Apart from some pretty shitty choice of words ('sprint' being the most egregious, but also 'backlog item' for all tasks, not just those beyond due-date; all designed to subtly force people to work harder for the same pay) the whole point of 'agile' seems to be to force all of the team to manage the team together. Which is ... a bit backwards. Firstly there's the problem of specialised skills and experience. It also exposes everyone to the responsibilities that managers "get paid the big bucks" for in compensation.
But ultimately it's just another overhead which interferes with actually getting work done. The point of a manager/team leader is to grease the wheels to let the other developers get work done as efficiently as possible and in a cohesive way. And people are different so more than one approach may be necessary. They usually never get to do any 'real work' themselves but without them (as in agile) nobody else does either. I sat through a 2 hour 'planning' meeting in abject horror as they seemed to mostly just group-operate a bug tracker. Something which could have taken the team leader 15 minutes of his own time (and the bigger items could have been done properly rather than just a hand-wavy guesstimate). I'm sure my disgust was visible because i don't even try to hide it and i was too tired to care.
Anyway I did a little reading about it and it just seems like someone went and interviewed (or imagined) a bunch of 'highly productive' teams about their "process" and wrote it down in a book to make money - creating a whole new language in the process as a way to start a new religion (and more profits).
But they forgot the key element: teams are made of people. And people are ultimately what make the team work regardless of (and often in spite of) any processes in place. But this has probably been forgotten on purpose, books like this are for management who wants to treat individual employees as identical resource units to be reallocated and 'consumed' at will.
I can see agile working ... but only in environments and on projects where it was never needed to start with and in those it would only add unnecessary and considerable overheads. This kind of magic cannot be bottled into self-help books which is all these types of books are and why these things are so faddish. Like self-help books if they actually worked the whole self-help publishing industry would collapse.
The whole two-week lock-step milestone thing is just nonsense too. There's never time to do any big architectural changes should they be required so they are never even suggested. And even little tasks just keep bouncing along across 'sprints' if they need to anyway it just means more wasted group-management time rather than letting them sit in the bug tracker till they're ready to be done.
I think like maven/ant they also forgot that a product which keeps the customer happy is the ultimate goal, not adherence to processes and racking up the count of passing short and arbitrary milestones.
But it's my day off ... but i'm too tired to do anything so I might just try to catch up on sleep and let my legs recover from the cycling. I haven't done this much for years and I was pretty much at my limit getting home yesterday; at least that's something that should improve quickly.
linaro arm gnueabihf cross compilers on Slackware64
I've been trying to get a full cross compilation setup going for the parallella but had way more trouble than I should have getting the cross compiler for arm going. I'm using the linaro sources but can't use the binaries I saw because Slackware64 isn't setup for multilib by default and I didn't want to turn it on. It turned out to be easy but I kept getting wrong arguments from old web pages or got the wrong info from others that weren't doing quite the same thing.
It's very well possible there are binaries elsewhere but I didn't see them; and in any case getting this to work is a lot more useful for me. The linaro build tool 'crosstool-ng' seems to expect debian and/or ubuntu and simply didn't work.
I started from linaro-toolchain-binaries page, and downloaded the full sources sources part 1 and part 2 (although part2 is just the linux kernel source which isn't necessary).
First, some variables/setup which makes it work:
top=`pwd`
prefix=/home/notzed/cross
mkdir -p ${prefix}
export PATH=${PATH}:${prefix}/bin
prefix is the install location.
tar xvjf ~/Downloads/gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src-part1.tar.bz2
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/gmp-5.0.2.tar.bz2
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/libiconv-1.14.tar.gz
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/expat-2.1.0.tar.gz
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/gdb-linaro-7.6.1-2013.10.tar.bz2
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/zlib-1.2.5.tar.gz
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/isl-0.11.1.tar.bz2
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/gcc-linaro-4.8-2013.10.tar.xz
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/linaro-prebuilt-sysroot-2013.10.tar.bz2
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/binutils-linaro-2.23.2-2013.10-4.tar.bz2
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/mpfr-3.1.0.tar.xz
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/pkg-config-0.25.tar.gz
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/cloog-0.18.0.tar.gz
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/md5sum
gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/mpc-0.9.tar.gz
Then untar the interesting ones in a way that the configure scripts expect. I use a script for this but this is what it executes:
mkdir -p build
tar xJf gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/gcc-linaro-4.8-2013.10.tar.xz -C build
mv build/gcc-linaro-4.8-2013.10 build/gcc-linaro
tar xjf gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/binutils-linaro-2.23.2-2013.10-4.tar.bz2 -C build
mv build/binutils-linaro-2.23.2-2013.10-4 build/binutils-linaro
tar xjf gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/linaro-prebuilt-sysroot-2013.10.tar.bz2 -C ${prefix}
tar xjf gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/gmp-5.0.2.tar.bz2 -C build
ln -s ../gmp-5.0.2 build/gcc-linaro/gmp
tar xzf gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/mpc-0.9.tar.gz -C build
ln -s ../mpc-0.9 build/gcc-linaro/mpc
tar xJf gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/mpfr-3.1.0.tar.xz -C build
ln -s ../mpfr-3.1.0 build/gcc-linaro/mpfr
tar xzf gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_src/zlib-1.2.5.tar.gz -C build
ln -s ../zlib-1.2.5 build/gcc-linaro/zlib
The
Then the building, just two stages: binutils then gcc. The sysroot from linaro is used and contains libc and so on.
Binutils is straightforward and only takes a minute or so to build.
top=`pwd`
mkdir -p ${top}/build/binutils-build
cd ${top}/build/binutils-build
../binutils-linaro/configure \
--prefix=${prefix} \
--target=arm-linux-gnueabihf \
--disable-nls --disable-werror \
--with-sysroot=${prefix}/linaro-prebuilt-sysroot-2013.10
make -j8
make install
Then gcc. This was the painful one ... but to cut the long story short this is what I did to get it to work. It takes a few minutes to build.
mkdir -p ${top}/build/gcc-build
cd ${top}/build/gcc-build
../gcc-linaro/configure \
--prefix=${prefix} \
--host=x86_64-linux-gnu \
--build=x86_64-linux-gnu \
--target=arm-linux-gnueabihf \
--with-float=hard --with-arch=armv7-a -with-fpu=vfpv3-d16 \
--disable-nls --disable-werror \
--enable-languages=c,c++ \
--with-sysroot=${prefix}/linaro-prebuilt-sysroot-2013.10
make -j8
make install
*shrug* I can't really say whether it's right or wrong but - but it worked well enough to cross compile a working binary.
The ezesdk
So mostly why I did this was so that I could do some re-arranging of the elf-loader code into a more wide-reaching library and keep working on it locally on my workstation rather than having to do it on the parallella. Not that it isn't fast enough to do the little bit of compiling I need - it certainly is - it was just all done on a whim really (one that drew out to a good few hours although not particularly intense ones, in between making another batch of biltong, cooking some corned beef, drinking, and surfing the web).
Another whimsical decision was to fork the epiphany e-hal library. This ... isn't really something I originally intended to do because it just means more to maintain and also there may be future functionality that would be best kept there - such as multi-process arbitration and so forth. But I guess one small but real justification is that right now I need to access some private (-local) data structures which are presumably 'private' for a reason; and if they ever really went private things would break.
Anyway ... I've just been extremely tired the last few days and a bit distracted by some stuff (to somewhat understate it) so it may well just be a bad idea but I suppose i'll see how far I get. It's taken long enough just to decide on a directory layout. At this point i'm going to have libezehost.so which will be the host driver (e-hal + elf-loader, etc), and libezecore.a which will be the on-core api (i.e. e-lib equivalent) although much of it is inline.
I unfortunately have to start working on that other project tomorrow which means a long commute on cyclist hostile roads (more so than average) so tonight better be an early one. Just as well i'm totally knackered and might not even make 10pm - although daylight saving just ended today so it's "really" later than that.
Quick swing by JavaFX
Had a chance to poke around a small JavaFX application for the customer for a couple of days. Unfortunately i've been 'booked' for other work for the next few months so I'm still not getting as much of a chance to play with JavaFX as i'd hoped. Might be the last too (on that s/w) as this new work thrust on me is basically an unrelated graduate-level task in a graduate-level work environment, and that's the least of the issues with it (not too happy right now but i'll have to see how it transpires).
Anyway ... I'm still having issues with layouts although in my particular problem I think it came down to not realising that the scale pivot point is the centre of objects. I had inconsistent/jumping ui's as things changed so it just looked like a layout bug.
I had a few hours left after adding the required functionality so I thought i'd tart it up a bit with clipboard and then drag and drop support. Nice ... it's nice. Just simple and hides all the data-type negotiation and whatnot; something that made sense in 90s era computers without the memory (and also high hopes of extensive functionality) but now there's no real need for it (and dnd is mostly used for stupid things like editing text where it doesn't make sense because of it's clumsiness, and not for file opening where it does). One of those things were a really good style guide might have helped rather than a free-for-all.
As an example this function pointer (or method handle, or whatever it is) can just be added to any ImageView to make it draggable as a picture - e.g. to drop into a picture editor.
static EventHandler<MouseEvent> dragImageView = (MouseEvent event) -> {
ImageView iv = (ImageView) event.getSource();
Image im = iv.getImage();
if (im != null && im.getProgress() == 1) {
Dragboard db = iv.startDragAndDrop(TransferMode.COPY);
ClipboardContent cc = new ClipboardContent();
cc.putImage(im);
db.setContent(cc);
event.consume();
}
};
// any image view not in a list:
iv.setOnDragDetected(dragImageView);
Dragging from lists has to go on the list not the imageview, though isn't much more work.
The clipboard is even a bit easier although I did some strange behaviour with it losing track of the content of the clipboard from another application if it the copy was done when the JavaFX application wasn't already running.
It doesn't seem to support the primary selection though which is a bit of a bummer. Not that most applications that use it do it properly any more :( You do have to stop highlighting the selection when you lose it!
I realised the last time I properly looked at cut and paste was about 15 years ago with gnome-terminal ... hmm.
Compositing
I'm still needing to use BufferedImage for I/O but one of the things I was worried about was whether I would still need to use it for composition. Looks like I don't and depending on how one feels about the javafx layout and blending stuff it offers "all the power" of that - as well as CSS. You just set up an off-screen scene and either snapshot that or one of it's components.
Scene s = new Scene(root);
WritableImage wi = s.snapshot(null);
If you want alpha to make it through to the output:
s.setFill(Color.TRANSPARENT);
root.setBackground(Background.EMPTY);
(actually that is pretty nice, and about time you're able to unify off-screen and on-screen layout and composition. And the api doesn't prevent the implementation using hardware to speed it up either).
One thing I found a little frustrating is the fact that none of the layout objects clip their content. This makes sense but it ended up not quite working properly when I added it to what I thought was the right place - suddenly all my alpha compositing simply stopped working. I had to wrap the container inside another one and just set the clip on the outer container that then when into a BorderPane or whatever it was. Around this time was when I was also having the strange jumping layout issues so that artificially inflated the frustration level.
So just as i'm starting to get the feel of it after a few short hours ... i'm pulled away again.
(Not that I can't work on something at home ... which i probably will once this parallella has run it's course).
Update: So the "real" customer had a look-see this week and apparently were pretty impressed. Not that the JavaFX had much to do with it but it didn't hurt i'm sure. As I said to the PM afterwards and I quote "they're probably used to seeing some matlab piece of shit that takes days to run" ... anyway I guess we'll see if any more money comes along. If so it could be quite interesting indeed - although again, not particularly for JavaFX related reasons.
async copies
I had a play with this idea far too late into the night last night. A dma memcpy is a fine idea and has some benefits but isn't really taking advantage of the hardware features nor providing much opportunity to deal with some of it's problems.
You can resort to manual dma but that is pretty fiddly and bulky code-wise and it's such a common operation it makes sense to have it available in the runtime. And once it's in the runtime the runtime itself can use it too.
My current thoughts on the api and implementation follow.
// incase an int isn't enough at some point
typedef unsigned int ez_async_t;
// Enqueue 1d copy
ez_async_t ez_async_memcpy(void *dst, void *src, size_t size);
// Enqueue 2d copy
ez_async_t ez_async_memcpy2d(void *dst, size_t dstride,
void *src, size_t sstride,
size_t width, size_t height);
// Wait till dma is done
void ez_async_wait(ez_async_t aid);
// Query completion status
int ez_async_complete(ez_async_t aid);
To drive it I have a short cyclic queue of dma header blocks which are written to by the memcpy functions. If the queue is empty when the memcpy is invoked it fires off the dma.
The interesting stuff happens when the queue is not empty - i.e. a dma is still outstanding. All it does in that case is write the queue block and increment the head index and return. Ok that's not really the interesting bit but how the work is picked up. A dma complete interrupt routine checks to see if the queue is not empty and if not then starts the next one.
If the queue is full then the memcpy calls just wait until a slot is free.
I haven't implemented chaining but it should be possible to implement - but it might not make a practical difference and adds quite a bit of complication. Message mode is probably something more important to consider though. This api would use channel 1, leaving 0 for application use (or other runtime functions with higher priority) although if it was flexible enough there shouldn't be a need for manual dma and perhaps the api could support both. It would then need two separate queues and isr's to handle them and would force all code to use these interfaces (it could always take an externally supplied dma request too).
This is the current (untested again) interrupt handler. I managed to get all calculations into only 3 registers to reduce the interrupt overheads.
_ez_async_isr:
;; make some scratch
;; this can cheat the ABI a bit since this isr has full control
;; over the machine while it is executing
strd r0,[sp,#-2]
strd r2,[sp,#-1]
;; isr must save status if it does any alu ops
movfs r3,status
;; Advance tail
mov r2,%low(_dma_queue + 8)
ldrd r0,[r2,#-1] ; load head, tail
add r1,r1,#1 ; update tail
str r1,[r2,#-1]
;; Check for empty queue
sub r0,r0,r1
beq 4f
;; Calc record address
mov r0,#dma_queue_size-1
and r0,r0,r1 ; tail & size-1
lsl r0,r0,#5 ; << record size
add r0,r0,r2 ; &dma_queue.queue[(tail & (size - 1))]
;; Form DMA control word
lsl r0,r0,#16 ; dmacon = (addr << 16) | startup
add r0,r0,#(1<<3)
;; Start DMA
movts dma1config,r0
4:
;; restore state
movts status,r3
ldrd r2,[sp,#-1]
ldrd r0,[sp,#-2]
rti
When I wrote this I thought using 32-bytes for each queue record would be a smart idea because it simplifies the addressing, but multiply by 24 is only 2 more instructions and a scratch register over multiply by 32 so might a liveable expense. The address of the queue is loaded directly so that saves having to add the offset to .queue when calculating the dma request location.
The enqueue is simple enough.
// Pads the dma struct to 32-bytes for easier arithmetic
struct ez_dma_entry_t {
ez_dma_desc_t dma;
int reserved0;
int reserved1;
};
// a power of 2, of course
#define dma_queue_size 4
struct ez_dma_queue_t {
volatile unsigned int head;
volatile unsigned int tail;
struct ez_dma_entry_t queue[dma_queue_size];
};
struct ez_dma_queue_t dma_queue;
...
uint head = dma_queue.head;
int empty;
// Wait until there's room
while (head - dma_queue_size >= dma_queue.tail)
;
... dma_queue[head & (dma_queue_size-1)] is setup here
ez_irq_disable();
// Enqueue job
dma_queue.head = head + 1;
// Check if start needed
empty = head == dma_queue.tail;
ez_irq_enable();
if (empty) {
// DMA is idle, start it
ez_dma_start(E_REG_DMA1CONFIG, dma);
}
return head;
The code tries to keep the irq disable block as short as possible since that's just generally a good idea. With interrupts this is basically equivalent to a mutex to protect a critical section.
Copyright (C) 2019 Michael Zucchi, All Rights Reserved.
Powered by gcc & me!