lib/grizzly/zwave/commands/node_provisioning_list_iteration_get.ex

defmodule Grizzly.ZWave.Commands.NodeProvisioningListIterationGet do
  @moduledoc """
  Module for working with the `NODE_PROVISIONING_LIST_ITERATION_GET` command

  This command is used to read the entire the provisioning list.

  Params:

    - `:seq_number` - the network command sequence number (required)
    - `:remaining_counter` - indicates the remaining amount of entries in the
      Provisioning List, not provided if starting (optional)

  """

  @behaviour Grizzly.ZWave.Command

  alias Grizzly.ZWave
  alias Grizzly.ZWave.Command
  alias Grizzly.ZWave.CommandClasses.NodeProvisioning

  @type param ::
          {:seq_number, ZWave.seq_number()} | {:remaining_counter, non_neg_integer()}

  @impl true
  def new(params) do
    command = %Command{
      name: :node_provisioning_list_iteration_get,
      command_byte: 0x03,
      command_class: NodeProvisioning,
      params: params_with_defaults(params),
      impl: __MODULE__
    }

    {:ok, command}
  end

  @impl true
  def encode_params(command) do
    remaining_counter = Command.param(command, :remaining_counter, 0xFF)
    seq_number = Command.param!(command, :seq_number)
    <<seq_number, remaining_counter>>
  end

  @impl true
  def decode_params(<<seq_number, remaining_counter>>) do
    if remaining_counter == 0xFF do
      {:ok, [seq_number: seq_number]}
    else
      {:ok, [seq_number: seq_number, remaining_counter: remaining_counter]}
    end
  end

  defp params_with_defaults(params) do
    defaults = [remaining_counter: 0xFF]
    Keyword.merge(defaults, params)
  end
end