# Describes the format for available MQTT services

publish:
  description: Publish a message to an MQTT topic.
  fields:
    topic:
      description: Topic to publish payload.
      example: /homeassistant/hello
    payload:
      description: Payload to publish.
      example: This is great
    payload_template:
      description: Template to render as payload value. Ignored if payload given.
      example: "{{ states('sensor.temperature') }}"
    qos:
      description: Quality of Service to use.
      example: 2
      values:
        - 0
        - 1
        - 2
      default: 0
    retain:
      description: If message should have the retain flag set.
      example: true
      default: false

dump:
  description: Dump messages on a topic selector to the 'mqtt_dump.txt' file in your config folder.
  fields:
    topic:
      description: topic to listen to
      example: "OpenZWave/#"
    duration:
      description: how long we should listen for messages in seconds
      example: 5
      default: 5

reload:
  description: Reload all mqtt entities from yaml.
