Swap in your own part

Every part of Tersenet has a reference version in the sources, and each can be replaced on its own: you can test your part with all the others still the reference's. This page gives the command for each case. The commands run from the top folder of the Tersenet sources, after cargo build --release, with target/release on your PATH; tersereader is built in native/reader-go as its README says.

Your reader, the reference network

Run a relay, terse-relay --store try-relay, and point your reader at ws://127.0.0.1:7878. Publish to it with terse feed publish (step 3 of the reader guide). Or let the reference node do the network and talk to it over its socket:

terse node

tersereader node answers the same messages, so you can try your reader on both.

Your core, the reference devices

A core that speaks the device bus (DEVICES.md section 12 lists what it must do) starts the reference drivers, terse-dev-terminal, terse-dev-vector and the others, from one folder. tcore is such a core; it takes the folder with --drivers:

native/core-c/tcore programs/hello/hello.terse \
    --frames 30 --hash --drivers target/release
terse run programs/hello/hello.terse --frames 30 --hash

Both print the same hash. Do the same with your core.

Your device, the reference core

terse-bus programs/hello/hello.terse --frames 30 --hash \
    --driver 2=$PWD/terminal

as on the previous page. --driver takes any slot of a device of the specification: 3,9= for the vector displays, 4= for content, 6= sound, 7= the page.

Install your device

To have terse-bus use your driver every time, with no --driver, install it:

terse drivers add terminal
terse-bus programs/hello/hello.terse --frames 30 --hash

add starts the driver once to ask what it is, shows its name, version, build and slots, and copies it into your configuration folder. A driver runs with your full rights, so install only ones you trust; nothing but this command installs one. terse drivers list shows which driver each device gets. terse drivers use 2 default goes back to the reference terminal, and terse drivers remove terminal-example removes yours. If your driver cannot start, terse-bus says so and uses the reference one. The rules are in DEVICES.md section 2.2.

Your device under your core

tcore takes --driver too, so the example driver runs under a core that is not the reference's either:

native/core-c/tcore programs/hello/hello.terse --frames 30 \
    --hash --drivers target/release --driver 2=$PWD/terminal

What does not work yet

What you have now

The means to test any part you write against the reference, one part at a time. Next, the program that holds a whole system of machines together: Make a shell.