Pi5 uses the latest version of the “Raspberry Pi OS”, which is currently Deban bookworm with a Linux kernel 6.6.51. That breaks some stuff expected by the Piface “pifacedigitalio” library.

The first (unexpected) change is that we can’t use PIP to install packages in the system-wide Python provided by the Debian install. Instead a virtual env is enforced to ensure such packages do not break the entire system.

There is apparently a flag “pip --break-system-packages” that works around that check, and interestingly that option is not in the man page.

For a quick test, there’s some value in using a virtual env folder that I’m going to trash later.

The next realization is that none of the stuff works anymore:

Error “No such file or directory: '/sys/class/gpio/gpio25/value”

On an RPi 1, that means the user is not part of the group “gpio”.

Here it is apparently due to the fact that the GPIO driver has been changed and the “sysfs” paths are no longer valid. Fun. The core issue seems to be with GPIO interrupts here: https://github.com/piface/pifacecommon/blob/master/pifacecommon/interrupts.py

This describes the (now deprecated) sysfs interface: https://www.kernel.org/doc/Documentation/gpio/sysfs.txt

Translating these:

• The old way was to “echo 25 > /sys/class/gpio/export”
• That would make create/expose “/sys/class/gpio/gpio25/” at which points the pseudo files for direction etc could be used.

However:

• Instead now we have /sys/class/gpio/gpiochip512/base (512) + /sys/class/gpio/gpiochip512/ngpio (58) which means this controller handles gpio’s in the range 512..up to 570 excluded. Then there’s “gpiochip570” which has base=570 and ngpio=8.
• “$ gpioinfo | grep 25” ⇒ this lists all the pins and we can find that “GPIO25” is actually #25 (from 0-base) on that gpiochip0 which is actually the giochip512 above.
• 512 + 25 = 537… so that’s the new “sysfs” number for GPIO25.
• $ echo 537 | sudo tee /sys/class/gpio/export
• ⇒ And that makes “/sys/class/gpio/gpio537/” appear.

https://play.google.com/store/apps/details?id=net.christianbeier.droidvnc_ng

and

https://github.com/bk138/droidVNC-NG

There are 2 things that interest me here:

• This app auto-starts using the Accessibility API. I want to understand that API so that I can use it in TCM, since Android 14 does not support the old “Boot Receiver” method.
• What are the steps needed to embed a VNC server in an app?
• A use case would be TCM sharing its own view, without access to the entire tablet. Is it worth it to even consider that, or just install DroidVNC-NG on the side?

Accessibility Service API

https://developer.android.com/guide/topics/ui/accessibility/service

What it is:

• Android 8 (API 26) and above.
• A service, declared in the manifest.
• It can listen to events, and inspect the view hierarchy.
• “Explore by Touch”: respond to gestures by interacting with screen elements.
• AccessibilityService#performGlobalAction to perform an action.
• AccessibilityService#getSystemActions to figure available actions.

It doesn’t seem like an AccessibilityService could start an app directly per se.

However it could potentially use GLOBAL_ACTION_HOME to invoke the Home app, then explore the hierarchy and click on the relevant app icon to trigger it. It’s not clear whether the service can do that on its own; it’s likely it needs to respond to a user gesture first.

ACTION_BOOT_COMPLETED and RECEIVE_BOOT_COMPLETED

https://kotlinlang.org/docs/multiplatform.html 

Evaluate this against my needs:

• Android development
• Web development
• Existing libraries

Rationale: KMP is all about the “multiplatform” aspect. I have zero multiplatform projects.

Android development: I don't do Android/iOS parity, so is there a point over Android Kotlin native? I doubt so.

Web development: This is competing with Flutter. I'm fine with Dart and Flutter. It beats anything React, whilst being mostly the same design. There are good libraries to interact with GCloud, Firebase, and it's been easy to find 3rd party libraries when needed.

Framework updates are the only thing tedious.

Before starting the Flutter way, I remember trying “Kotlin for the web” and that was not good. Was it KMP? Worth another look. Criterias are IDE support, Firebase integration support, framework updates, distrib size.

GDSCript: https://docs.godotengine.org/en/stable/tutorials/scripting/gdscript/index.html

https://docs.godotengine.org/en/stable/tutorials/scripting/gdscript/static_typing.html

var damage = 10.5                                ⇒ no typing, this is essentially a Variant

var damage:= 10.5                                ⇒ inferred typing

var damage: float = 10.5                ⇒ explicit typing

For constants:

const MOVE_SPEED = 50.0                        ⇒ inferred (= and := are the same)

const MOVE_SPEED := 50.0                ⇒ inferred

const MOVE_SPEED: float = 50.0        ⇒ explicit

For functions:

func sum(a: float = 0.0, b: float = 0.0) -> float: …

func sum(a := 0.0, b := 0.0) -> float:

Which types to use:

https://docs.godotengine.org/en/stable/tutorials/scripting/gdscript/static_typing.html#what-can-be-a-type-hint

Types can be:

• Variant, void (only function return, see below)
• Built-in types, global classes, inner classes (gdscript has inner classes?!)
• Native classes, enums (gdscript has enums?!)
• Constants that are preloaded as class types (see below)

func blah() -> Variant: …         ⇒ forces the function to return something

func blah() -> void: …                 ⇒ forces the function to not return a value

https://amzn.to/4bJ0iUw is the 10 Inch Android 12 Tablet I’m using for Enphase Enlighen.

It has a 1280x800 screen.

Even though it’s a “production” one, I can run a debug app from Android Studio.

When enabling developer settings, there’s a Drawing > “Plus petite largeur d'écran” to control DPI:

• 432 dp ⇒ makes all takes larger (simulates smaller screen)
• 592 dp ⇒ the default value.
• 601 dp ⇒ better for Enphase (better view of the graph)
• 740 dp ⇒ makes everything look smaller (simulates larger screen like 1920x1200)

When trying out RTAC, the font for the throttles is way too big. It’s calibrated for the Chuwi’s 1920x1200 display. I realize I should customize it by “screen size”.

A few months ago I updated the Conductor project to new libraries, notably switching to Kotlin DSL 1.9. That made building with Java 11 a requirement.

In turn, that broke the way the Kotlin DSL is loaded under JMRI. I’m not sure why.

So fine, I reverted the Gradle files to a “Java 1_8” compatibility mode, and reverted to the older Kotlin DSL 1.6. This works fine when building the fat JAR, but it fails when trying to run the tests. It works fine when I actually build with a Java 1.8 JDK instead.

When building with Java 11 and running the tests, I get this cryptic gradle error: “Incompatible because this component declares an API of a component and the consumer needed a runtime of a component”

To be clear, the “build” part works. I get the fatJAR just fine. It’s the testing that fails, and only when doing it from Gradle on the command line. In IJ, I get the same behavior by selecting Conductor > All Tests on the root project.

I should try to replicate it with the gradle --info flag to see if that gives me more details on what is really breaking.

Another limitation is that only LibUtils v2 works with Java 1.8. LibUtils v3 already has Mockito dependencies that require Java 11.

But that seems all academic anyway. What I really want is to build with a Java 11 compatibility target since at this point even JMRI requires 11.

Then once I get that working, I need to retry with Kotlin DSL 1.9.

One thing for sure is from now on, when updating, I need to account for these scenarios:

• Testing does not work the same way under IJ or under command-line Gradle.
• Kotlin DSL loading does not work the same in standalone (simulator) vs from JMRI.

It’s time to update SDB to use more unique_ptr and/or shared_ptrs.

Some simple examples come to mind:

class SdbModManager {

    std::vector<SdbMod*> _mods;

    std::map<String, SdbMod*> _modsmap;

    std::vector<SdbSensor*> _sensors;

    std::vector<SdbServer*> _servers;

    std::vector<SdbBlock*> _blocks;

}

All these should be either unique or shared pointers to clarify the ownership.

There are 2 or 3 aspects to clarify:

• How a new object is created.
• How a ptr is “moved” into the vector.
• Users of the vector.

For each collection, I have a simple getter that returns the vector as a reference:

const std::vector<SdbServer*>& servers() const  { return _servers; }

and then I use that in a for/auto loop:

for(auto* s: _manager.servers()) { … s->name() …  }

The other kind of usage is the vector for Events. One goal here is to change that from a struct holding to holding unique ptrs, with the goal that events get automatically released when pulled out of the vector and used.

So first, I need to write down a few things about how to use unique_ptrs correctly.

https://en.cppreference.com/w/cpp/memory/unique_ptr

#include <memory>

auto p = std::unique_ptr<Class>(new Class())

std::unique_ptr<Class> function() {

  return std::unique_ptr<Class>(new Class());

}

C++ ref mentions creating the instances using std::make_unique(), but apparently I don’t have that in the ESP IDF projects (N.D.L.R. it should be in ESP IDF 5.x but I’m using the previous one).

Week of 2023-12-24 to 2023-12-31, I wrote Nerdkill Defold. Worked well, was easy to use and get something.

One thing that was nice was that I ported the original game, with all the original 8 “weapons”.

Started looking at Nerdkill w/ Godot 4.2, just to compare with Defold.

Not sure there's a point in concluding that one though.

A new Asqare using Godot 4 for Android would make more sense.

One angle of Nerdkill w/ Godot would be how to create a project that can produce both a web version and a mobile version? More specifically, I’d want the screen form factor to be different.

• Nerdkill “desktop” in landscape can use the cartouche with the 8 weapons.
• Nerdkill “mobile” in portrait can use the 5 weapons.

I could of course change the mobile version to have the same 8-weapons row, but I feel the mobile version looks better that way.

(Alternate idea: consider using 7 weapons on mobile; drop the flag. 2 rows of 5 slots each, the cartouche would occupy the 3 middle bottom slots.)

So one thing I realize I don’t know if it’s possible is to configure the window size dynamically, or at least static by export type. Or maybe it could be two projects using the same resources.

https://forum.godotengine.org/t/how-to-change-window-size-using-gdscript/2861/3

“get_window().size = Vector2i(width, height)”

https://docs.godotengine.org/en/stable/tutorials/rendering/multiple_resolutions.html

“the size in Project Settings > Display > Windows… think of it as the design size”

“to support both landscape and portrait, consider using e.g. 720x720”

Started going through the Defold tutorials.

I have 3 possible learning projects I could try with this:

• Nerdkill.
• Could be limited to an HTML5 output, purely as-is with no changes (e.g. no goals), and visible only via the Nerdkill web page.
• Asqare.
• This would be an Android output. I’d limit it to one of the 2 engines.
• One goal would be to “finish” the game by adding more animation / interactions, and power ups, and better scoring.
• Cangrejo.
• That could be HTML and Android.

On the Android side, an aspect would be to check the Play Game integration. E.g. leaderboards, achievements, profile management, saves/restores, etc.

One open question, similar to Godot: how does one separate the engine from UI, and how does one provide unit tests for the engine part? There seems to be a clear lack of MVC or MVP design in these tutorials.

Just a quick thought on something that still bugs me with Rig4’s generated blog:

• I write pages with 10 posts per page, from 00NN.html down to 0001.html.
• I then write an index with the 10 most recent posts.

The rationale is:

• The numbered pages are “stable”: older pages (with lower numbers) don’t change when new posts are added “normally”, that is when posts are added for the most recent day.
• It’s exceedingly rare that I’d add a “late” post in the middle.
• The last numbered page fills up and, once it reaches 10 posts, becomes stable.
• I never link to page numbers, but I do expect them to be indexed by search engines and I’d like these links to become stable.

The downside:

• The index page necessarily duplicates N < 10 posts from the last page.
• When clicking the “next page” button from the index, we land on the top most page, which basically duplicates the same content, and that’s a bit confusing.

That last bit is what annoys me. I don’t have a solution for it.