Native components of AndroWish

------------------------------

This directory holds the C/C++ components which are part of AndroWish.
It is built using the Android NDK. The build process is integrated
into the toplevel project but can be carried out manually by invoking
the `ndk-build` tool in this directory.

The `Android.mk` file in this directory invokes all dependent `Android.mk`
files below.

The `Application.mk` file controls NDK regarding prebuilt stuff,
Android API level, and most importantly the CPUs for which 
everything is to be built, e.g. ARM and x86 CPUs.

As of 2017-10-18 the following NDK revisions are known to build
everything without errors (but a varying amount of warnings):

	NDK r9d (March 2014)
	NDK r10e (May 2016)
	NDK r12b (June 2016)
	NDK r13b (October 2016)

The shiny new clang/llvm based NDKs with unified headers still fail:

	NDK r14b (March 2017)
	NDK r15c (July 2017)

As of 2018-02-09 the tree should build with `NDK r16b (December 2017)`
but this depends somewhat on the development system (Windows may fail).

For later NDKs it may be necessary to change the `APP_ABI` macro in
`Application.mk` to have `armeabi-v7a` instead of `armeabi`.

TDK
---

This is a stripped down TDK from
[https://github.com/andreas-kupries/tdk](https://github.com/andreas-kupries/tdk)
to be embedded into undroidwish/vanillawish.

The provided shortcuts to TDK tools are

	builtin:TDK/checker
	builtin:TDK/compiler
	builtin:TDK/debugger
	builtin:TDK/inspector
	builtin:TDK/tape
	builtin:TDK/tclapp
	builtin:TDK/tclsvc
	builtin:TDK/vfse

critcl-min
----------

This is a trimmed down `critcl 3.18.1` runtime mainly used to generate
the C source code for the `tcllib` accelerator functions. This version
is Tcl only, i.e. does not contain shared libs with Tcl extensions.

For full critcl see
[http://andreas-kupries.github.io/critcl](http://andreas-kupries.github.io/critcl).

piio
----

`piio` by Schelte Bron is a library for accessing a couple
of the I/O possibilities of the Raspberry Pi. The library
supports gpio, i2c, and spi.

Further reading

[http://chiselapp.com/user/schelte/repository/piio/home](http://chiselapp.com/user/schelte/repository/piio/home)

[http://wiki.tcl-lang.org/39548](http://wiki.tcl-lang.org/39548)

This is a derivative of "Snap7 IoT Package for Intel Quark architecure"
-----------------------------------------------------------------------


It generalizes the build for gcc supported platforms.


	# compile/link build/bin/libsnap7.so for POSIX
	cd build/unix
	make -f unix.mk

	# clean source tree for POSIX
	cd build/unix
	make -f unix.mk clean

	# compile/link build/bin/snap7.dll for WIN32/64
	cd build/win
	make -f win.mk

	# clean source tree for WIN32/64
	cd build/win
	make -f win.mk clean

tclwmf

------

Tcl interface to cameras using Windows Media Foundation

twapi
-----

This is the "Tcl Windows API" extension by Ashok P. Nadkarni.

See [http://twapi.magicsplat.com](http://twapi.magicsplat.com) for more information.

ulis
----

Tk megawidgets by ulis copied from [wiki.tcl-lang.org](http://wiki.tcl-lang.org), see also

[https://wiki.tcl-lang.org/page/hugecombo](https://wiki.tcl-lang.org/page/hugecombo)

[https://wiki.tcl-lang.org/page/Hugelist](https://wiki.tcl-lang.org/page/Hugelist)

[https://wiki.tcl-lang.org/page/Lightbutton](https://wiki.tcl-lang.org/page/Lightbutton)

[https://wiki.tcl-lang.org/page/Virtuallist](https://wiki.tcl-lang.org/page/Virtuallist)

This is a modified and trimmed down version which can be used
with AndroWish and undroidwish.

v4l2

----

Tcl interface to Video For Linux Two

wits
----

This is the "Windows Inspection Tool Set" by Ashok P. Nadkarni.

See [http://windowstoolset.magicsplat.com](http://windowstoolset.magicsplat.com) for more information.