cc-haxe/doc/Manual.md
2023-06-25 21:23:13 +02:00

3.2 KiB

Use this if you want to know how to use the OS.

Commands

Disk

Interact with a disk drive.

Synopsys:

  • disk ls list all disk drives and its content
  • disk play <drive> play an audio disk inside a disk drive
  • disk stop <drive> stops playing audio
  • disk eject <drive> ejects the disk
  • disk lable <dive> [lable] Reads or sets a lable on a disk.

GPS

Interact with the buildin GPS and INS (Inertial Navigation System) system. The INS is used to update a turtle's position when it is moving.

The GPS has 4 states of accuracy:

  • 0 Unknown position
  • 1 Position from INS or its best guess
  • 2 Position from manual input or the last known position
  • 3 Position from GPS

In case of a turtle the GPS accuracy will be set to 1.

Synopsys:

  • gps set <x> <y> <z> set the position manually. This will get saved.
  • gps status prints the current GPS accuracy, position and INS status.
  • gps locate try to locate the current position. Accuracy will be set to 3 if successful.
  • gps ins perform an INS alignment. Used to get the current heading.

KSettings

Get and set Kernel settings.

Current settings are:

  • hostname the hostname of the computer
  • sitecontroller the id of the site controller

Synopsys:

  • ks get <setting> print the value of a setting
  • ks set <setting> <value> set the value of a setting
  • ks list list all settings

LSPS

List all processes running on the computer. Very simple and not very useful other than for debugging.

Net

Interact with the network stack.

Synopsys:

  • net route print the routing table
  • net iface list all network interfaces
  • net proto list all network currently active protocols
  • net ping <id> ping a remote computer by id

Peripherals

Interact with the peripherals connected to the computer.

Synopsys:

  • perf inspect <peripheral> print all types and methods of a peripheral
  • perf list list all peripherals

Redstone

Interact with the redstone. Support for Project Red's Bundle Cable is partialy implemented.

Synopsys:

  • rs on <side> turn on redstone on a side
  • rs off <side> turn off redstone on a side
  • rs get <side> get the redstone state on a side

Service

Interact with the service manager. A service is a program that runs in the background and can be automatically started when the computer boots.

A service is a normal program. In order to create a new service you must register a command with arguments under a name. After that you can start the service by its name. If it is running you can enable it so it will be started when the computer boots.

Synopsys:

  • srv start <name> start a service
  • srv stop <name> stop a service
  • srv register <name> <binary> [args...] register a service
  • srv unregister <name> unregister a service
  • srv list list all services
  • srv enable <name> enable a service. Must be started before it can be enabled.

Turtle

Interact with a turtle. Very simple. More to come maybe.

Synopsys:

  • turtle forward move the turtle forward
  • turtle back move the turtle back
  • turtle up move the turtle up
  • turtle down move the turtle down
  • turtle left turn the turtle left
  • turtle right turn the turtle right