Skip to content

examples

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

examples

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
cli
cli
 
 
control-layer
control-layer
 
 
devices
devices
 
 
dsl
dsl
 
 
nlp2hillm
nlp2hillm
 
 
nlp2uri
nlp2uri
 
 
README.md
README.md
 
 
env.example
env.example
 
 
load-env.sh
load-env.sh
 
 
run-all-dry-run.sh
run-all-dry-run.sh
 
 

README.md

hillm examples — hardware smoke tests

Runnable scripts to exercise HILLM through CLI, DSL, NLP, and control-layer adapters. Scripts source load-env.sh which sets HILLM_DRY_RUN=1 by default.

Quick start

cd /home/tom/github/semcod/hillm
bash packages/install-dev.sh
cp examples/env.example .env   # append HILLM_DRY_RUN=1 if .env already exists

bash examples/cli/devices.sh
bash examples/dsl/run-smoke.sh
bash examples/run-all-dry-run.sh
make test-examples             # pytest wrapper for all CORE_SCRIPTS

Layout

Path Focus
cli/ hillm CLI — devices, scan, read, write, status
dsl/ dsl2hillm query/command smoke
control-layer/ uri2hillm, nlp2hillm, cli2hillm, rest2hillm
nlp2hillm/ NL → DSL mapping and --apply (dry-run default)
devices/ Per-category hardware profiles
nlp2uri/ nlp2uri compile + uri2hillm dispatch

cli/

Script What it tests
devices.sh hillm devices
scan.sh hillm scan
read-dry-run.sh hillm read --device sensor-temp --dry-run
write-dry-run.sh hillm write dry-run
status-ecosystem.sh hillm status --ecosystem
status-mouse-dry-run.sh hillm status --device mouse-default --dry-run
dsl-health.sh dsl2hillm HEALTH via CLI path

dsl/

Script What it tests
run-smoke.sh Multi-line smoke.dsl
read-sensor-temp.sh READ DEVICE sensor-temp dry-run
devices-usb.sh DEVICES CATEGORY usb

control-layer/

Script What it tests
uri-dispatch.sh uri2hillm HEALTH + READ URI
uri-shorthand-read.sh DSL shorthand READ DEVICE sensor-temp
uri-decode-sensor.sh uri2hillm decode hillm://… → DSL
nlp-to-dsl.sh NL temperature + modbus connect
nlp-mouse-port.sh PL mouse port → STATUS dry-run
dsl-live-policy.sh dsl2hillm dry-run default vs --live
cli-exec.sh cli2hillm passthrough
rest-health.sh REST server (optional, skip if offline)

nlp2hillm/

Natural language → DSL mapping and optional execution. Scripts use --no-llm for deterministic CI; live scripts skip gracefully when hardware or pyserial is missing.

Mapping only (to-dsl-*.sh)

Script Prompt Expected DSL
to-dsl-temperature.sh read temperature from serial READ DEVICE sensor-temp REGISTER temperature
to-dsl-mouse.sh read usb port for mouse READ DEVICE mouse-default
to-dsl-mouse-port-pl.sh na jakim porcie jest podłączona myszka? STATUS DEVICE mouse-default
to-dsl-mouse-status-en.sh what port is the mouse on STATUS DEVICE mouse-default
to-dsl-camera.sh capture image from camera ACTUATE DEVICE camera-usb ACTION capture
to-dsl-modbus-connect.sh connect modbus device CONNECT DEVICE modbus-rtu
to-dsl-list-usb.sh jakie urządzenia usb są podłączone DEVICES CATEGORY usb
to-dsl-health.sh HEALTH HEALTH

Execution (apply-*.sh)

Script What it tests
apply-read-dry-run.sh --apply default dry-run for READ
apply-env-dry-run.sh HILLM_DRY_RUN=1 from load-env
apply-connect-modbus.sh connect modbus device --apply
apply-status-mouse-dry-run.sh Polish mouse port → dry-run STATUS
apply-status-mouse-live.sh Live mouse under /dev/input/by-id
apply-verbose-rules.sh -v → # mapped via: rules
apply-temperature-live.sh Live serial read (skip without port/pyserial)
check-serial-env.sh Install + port resolution diagnostics
llm-openrouter.sh Optional LLM (skip without API key)

devices/

Category Device id Script
display / HDMI display-primary display/status.sh
camera camera-usb camera/capture-dry-run.sh
audio speaker-default audio/status.sh
USB usb-hub usb/list.sh
serial serial-ttyacm0 serial/read-dry-run.sh
Modbus modbus-tcp modbus/read-dry-run.sh
input / mouse mouse-default input/mouse-status-live.sh
sensor / temp sensor-temp sensor/temp-read-dry-run.sh
sensor / temp sensor-temp sensor/temp-status-live.sh
sensor / temp sensor-temp sensor/temp-resolve-address.sh

nlp2uri/

Script What it tests
compile-uri.sh nlp2uri compile
run-uri.sh uri2hillm dispatch

Requires pip install nlp2uri[hillm] (optional in CI).

Run all

bash examples/run-all-dry-run.sh
make test-examples

nlp2hillm --apply uses dry-run by default; pass --live for real hardware. Live scripts call unset HILLM_DRY_RUN because load-env.sh sets HILLM_DRY_RUN=1.

See also