Skip to content

Deutsch

Set the target on the device

A device on a Pallax template registers at Pallax with two values that belong to the device, not to the template:

Value Meaning
Pallax workspace The ID of your Pallax workspace.
Gateway type lorawan or mioty. It can differ from device to device.

Both are always set together. The template holds the settings your gateways share; the target holds where each one connects.

Where to set it

  • On the device: on the device's Configuration tab, in the card Pallax target, enter both values and click Save. Clear removes them. A device on a Pallax template that has no target is marked Template problem in the device list.
  • When assigning: if you assign a Pallax template to a device that has no target yet, the dialog Assign to template asks for both values and saves them together with the assignment. The assignment is refused without them.
  • Many devices at once: in the Devices list, tick the devices and click Set Pallax target. Each device is set on its own; one failing does not stop or undo the others.

A target is only for Pallax templates. A target for a device on a Generic template is refused instead of being ignored.

A target change reaches a device that is already provisioned only after Re-provision, see More device actions.

What the platform does at the device

A device that is marked Template problem is refused when it sets up or checks in, with TEMPLATE_INVALID. The reason is either device has no pallax target, followed by the value that is missing (set the target on the device), or _target in templates is no longer supported, set the target on the device (remove the key _target, even if it is null). A provisioned device keeps its profile and stays ready; a device that has no profile yet gets none.

No _target in the template

Earlier, the target was a key _target inside the template. That is over:

  • The console refuses to save a Pallax template that contains _target (when creating, in the editor and when pasting JSON).
  • The same rule holds for the API: it answers 422 with the code PALLAX_TARGET_IN_TEMPLATE.
  • Assigning a Pallax template to a device without a target is refused with 422 and the code PALLAX_DEVICE_TARGET_REQUIRED.
  • A template that still has the key from before is marked Target in template — remove it in the Templates list. Open it, remove the key _target, and set the target on the devices instead. Values are not copied to the devices for you.

If a device does not come up, see Troubleshooting.