The virtual hardware is among other purposses meant
to be used for debugging firmware issues.
The flag -Os optimizes out specific information that makes
proper debugging difficult in some situations.
Also, the virtual hardware does not come with restrictions
in terms of PROGMEM. That's why space efficiency is not needed there.
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
Some parts were moved over from Kaleidoscope-Hardware-Virtual.
The virtual hardware is now a drop in for the real
pluggable USB interface.
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
Consumer code can access the command line via
an additional callback of the virtual hardware.
This makes it possible to access the name of
the executable that is currently executed.
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
By this means it is possible to simplify running automatic
simulation based testing with virtual firmare builds.
If a firmware sketch defines a test function it will
be executed.
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
Through a command line parameter, the virtual
firmware executable can be instructed to execute
a testing function instead of processing
stdin/stdout I/O.
This can be used to attach an external
testing interface.
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
This commit re-enables virtual builds with the Model01 keyboard.
The commit also prepares the infrastructure to generate virtual builds with all other
keyboards currently supported.
Please note that this commit does not enable virtual builds of the stock firmware
right away. This is because currently the stock firmware uses the
Model01-Testmode which is not compatible with virtual builds.
The stock firmware could be made ready for virtual builds by replacing the
Model01-Testmode with the more general HardwareTestMode.
In general for those features/plugins that do not support virtual builds,
this commit adds the generation of compiler error messages
that inform about what parts of the sketch need to be changed to allow virtual
builds.
To allow the stock firmware to build for the virtual core, just remove the
Model01-TestMode, then run the build on a unixoid system as follows.
cd ..../libraries/Model01-Firmware
ARCH=x86 make
With this change, virtual builds are furtheron triggered via setting ARCH=x86.
The board that firmware is meant to be build for is defined through the
BOARD variable, just like with non-virtual builds.
Please note that it is currently not yet possible to run virtual builds for
other keyboards than the Model01. This as because only for the Model01
specification files Model01_Spec.h/cpp have been generated.
To enable virtual builds for all keyboards, specification files need to be
factored out for all keyboards apart from Model01.
After all keyboards will have been made available to virtual builds
through future changes, it will be possible to build the whole examples set
as
cd ..../libraries/Kaleidoscope
ARCH=x86 BOARD_HARDWARE_PATH=$PWD/../../../.. make smoke-examples
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
The two contained c++ files are almost identical to those
in KeyboardioHID.
The HID library is not used by the build. Checks prove that two
firmware binaries build with and without the library are identical.
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
In rare occasions during development when e.g. a missing symbol caused
the linker process to abort, the joined library was not removed
at the end of the build. In subsequent builds this possibly
caused problems during creation of the joined library as a
static library cannot be updated but must be removed and re-created.
This change solves the described problem by removing a possibly
pre-exising joined library before the link.
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
Before this change, when Arduino was linking the elf binary, it added all
objects and archives (libraries/plugins) to a long linker command line.
This would sometimes cause issues due to the linker's gargabe collection feature.
When one library A referenced a symbol from a library B but library A appeared after B
in the linker command line, the referenced symbol was in some cases garbage
collected as to the linker it appeared to be unreferenced.
To understand this better it is important to know that the linker processes
objects and archives one by one in the order of their appearance at the command
line. For every object or archive encountered it runs garbage collection individually.
That's why symbols might get discarded although an object or archives that is
encountered later on while processing the linker command line might have referenced it.
To fix this problem this commit divides up the linker process into two steps.
First, all objects and archives are combined in a large .a archive. Then, this
archive is passed to the original linker command line, thereby replacing the
original set of objects and archives.
The final link now sees all symbols together. Thus, it is able to determine the true
interdependencies and do a proper garbage collection without accidentally
generating unresolved symbols.
With this fix, the order of appearance of include directives in the sketch file that formerly had an
influence on the link order (as Arduino passes library archives to the linker in
the order of the appearance of the matching includes in the sketch),
can now be savely chosen arbitrarily.
To erase the joined archive file that is generated from all objects and
archives, we have to use different solutions on Linux/macOS and Windows. This is
done via defining tools.rm.cmd differently for those platforms.
Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
The library is being superseded by a hardware base class in Kaleidoscope itself.
As it is not used anywhere, and served only documentation purposes, remove it.
Signed-off-by: Gergely Nagy <algernon@keyboard.io>
Not having a default means that arduino-builder will not use any extra flags.
With the default set to the same as the Post-2016 PCB (the most recent one), the
Atreus example in Kaleidoscope will compile again.
Signed-off-by: Gergely Nagy <algernon@keyboard.io>
As a side effect, this changes the dfu-programmer invocation in platform.txt for
all boards (Planck included) that use it.
Signed-off-by: Gergely Nagy <algernon@keyboard.io>
