FeelNeedy 4075B Cat Litterbox

[Doughboy68]

Hi, I just got this cat litterbox a week ago. This is first time I have created a config file or worked with tuya-local. I have created a config file for it an it is pretty much done after a bunch of testing over the past few days.

Some notes, not complete...

DP 103 and DP 104 I investigated the sleep start and end time if that is possible to convert inside yaml without helpers but everything I have seen indicates no. The times are based on minute of the day with 12:00a being 0 min and 10pm (22:00hr) is 1320 min. This will need template helpers in home assistant if wish to view and edit in 24hr time but I don't see a real reason to do since these are not changed that often and simple to figure out and set once you know how the format.

DP 120 Cat Weighing... does not line up with anything in the Smarlife app. The Smartlife app has its own Cat Weight toggle which is not linked with this, and all that does in app is enable/disable the cat weight in the calendar history so it is an app specific setting. I am not sure what this is and is rw in the dev file therefore I have just made it a binary sensor to display its value instead of being able to turn on/off since it may be a master override for the scale due to safety concerns. I may have tested this already and had no effect on the weighing but no point in testing this further.

DP 119 I left Raw Toileting Record which contains the duration and weight. I left in for completeness. It always outputs in grams no matter what the setting is in the litterbox (DP 118). I also have sensors on DP 119 that convert the duration and raw weight kg and lb to values for ease of monitoring in home assistant.

Automatic Cleaning Type DP 124 I am not sure what this means regarding schedule clean and manual .. seems to be stuck on manual setting on mine so I just named it On-Demand so looks better in dashboard (the litterbox still detects cats and cleans automatically). It also has Empty Litter. This is a rw DP and could be made a selection, but I chose to make it a sensor instead for safetwy... since Empty Litter may actually dump the litter which someone could do by accident remotely. There is no setting to dump litter in Smartlife app and has to be done manually on the machine as per manual. I did not feel like testing this so not sure. Maybe I will look into this in future when I want to dump the litter.

Bit more testing and I think it is ready for a PR.

Here is full config file
feelneedy_4075b_litterbox.yaml

name: Feelneedy cat litterbox
products:
  - id: custom_litterbox
    name: FEELNEEDY 4075B Smart Automatic Self-Cleaning Cat Litter Box

poll_interval: 10
entities:

  # ==================== STATUS SENSORS ====================

  - entity: sensor
    name: Status
    class: enum
    icon: "mdi:refresh-circle"
    dps:
      - id: 111
        type: string
        name: sensor
        mapping:
          - dps_val: "satnd_by"      # Typo verified from live network logs
            value: "Standby"
          - dps_val: "return"
            value: "Homing"
          - dps_val: "clump"
            value: "Clumping"
          - dps_val: "cover"
            value: "Burying"
          - dps_val: "clean"
            value: "Clean"
          - dps_val: "calibrate"
            value: "Calibrating"
          - dps_val: "smooth"
            value: "Smoothing"
          - dps_val: "scoop"
            value: "Emptying"
          - dps_val: "sleep"
            value: "Sleeping"
          - dps_val: "cat_come_near"
            value: "Cat Approaching"
          - dps_val: "cat_inside"
            value: "Cat Inside"

  - entity: sensor
    name: Last Use Duration (Direct)
    class: duration
    icon: "mdi:timer-outline"
    category: diagnostic
    dps:
      - id: 106
        type: integer
        name: sensor
        unit: s

  - entity: sensor
    name: Defecation Count
    category: diagnostic
    icon: "mdi:counter"
    dps:
      - id: 105
        type: integer
        name: sensor


  # ==================== OPERATION CONTROLS ====================

  - entity: switch
    name: Clean
    icon: "mdi:shimmer"
    dps:
      - id: 108
        type: boolean
        name: switch

  - entity: switch
    name: Reset Weight Calibration
    icon: "mdi:scale-balance"
    dps:
      - id: 110
        type: boolean
        name: switch


  # ==================== DEVICE CONFIGURATIONS ====================

  - entity: select
    name: Entrance Mode
    icon: "mdi:door-open"
    category: config
    dps:
      - id: 123
        type: string
        name: option
        mapping:
          - dps_val: Low
            value: Low
          - dps_val: Medium
            value: Medium
          - dps_val: High
            value: High

  - entity: select
    name: Weight Unit
    category: config
    icon: "mdi:weight"
    dps:
      - id: 118
        type: string
        name: option
        mapping:
          - dps_val: kg
            value: Kilograms (kg)
          - dps_val: lb
            value: Pounds (lb)

  - entity: number
    name: Clump Delay Time
    icon: "mdi:timer-sand"
    category: config
    dps:
      - id: 101
        type: integer
        name: value
        unit: min
        range:
          min: 1
          max: 30

  - entity: light
    name: Light
    category: config
    dps:
      - id: 116
        type: boolean
        name: switch

  - entity: switch
    name: Beep
    category: config
    dps:
      - id: 117
        type: boolean
        name: switch

  - entity: switch
    name: Auto Recovery
    category: config
    icon: "mdi:refresh-auto"
    dps:
      - id: 122
        type: boolean
        name: switch

  - entity: switch
    name: Cat Approaching
    category: config
    icon: "mdi:radar"
    dps:
      - id: 109
        type: boolean
        name: switch

  - entity: switch
    name: Sleep Mode
    category: config
    icon: "mdi:bed"
    dps:
      - id: 102
        type: boolean
        name: switch

  - entity: switch
    name: Child Lock
    category: config
    icon: "mdi:account-lock"
    dps:
      - id: 112
        type: boolean
        name: switch

  - entity: switch
    name: Kitten Mode
    category: config
    icon: "mdi:cat"
    dps:
      - id: 113
        type: boolean
        name: switch

  - entity: number
    name: Sleep  Start
    category: config
    icon: "mdi:clock-start"
    dps:
      - id: 103
        type: integer
        name: value
        unit: min
        range:
          min: 0
          max: 1440

  - entity: number
    name: Sleep End
    category: config
    icon: "mdi:clock-end"
    dps:
      - id: 104
        type: integer
        name: value
        unit: min
        range:
          min: 0
          max: 1440


  # ==================== DIAGNOSTICS & SYSTEM STATES ====================

  - entity: sensor
    name: Cat Weighing
    class: enum
    category: diagnostic
    icon: "mdi:scale-bathroom"
    dps:
      - id: 120
        type: boolean
        name: sensor
        mapping:
          - dps_val: true
            value: "Enabled"
          - dps_val: false
            value: "Disabled"

  - entity: sensor
    name: Automatic Cleaning Type
    class: enum
    icon: "mdi:cog"
    category: diagnostic
    dps:
      - id: 124
        type: string
        name: sensor
        mapping:
          - dps_val: "0automatic_cleaning"
            value: "Scheduled Clock"
          - dps_val: "1manual_clean"
            value: "On-Demand"
          - dps_val: "2empty"
            value: "Empty Litter"


  # ==================== HARDWARE FAULTS (DP 114) ====================
  # Using 'type: bitfield' to expose individual, concurrent binary sensors.
  # Bit 0 (value 1) serves as the general safety interrupt/radar trip.

  - entity: binary_sensor
    name: Proximity Safety Trip
    class: motion
    category: diagnostic
    dps:
      - id: 114
        type: bitfield
        name: sensor
        mapping:
          - dps_val: 1
            value: true
          - value: false

  - entity: binary_sensor
    name: Motor Jammed
    class: problem
    category: diagnostic
    dps:
      - id: 114
        type: bitfield
        name: sensor
        mapping:
          - dps_val: 2
            value: true
          - value: false

  - entity: binary_sensor
    name: Side Cover Open
    class: door
    category: diagnostic
    dps:
      - id: 114
        type: bitfield
        name: sensor
        mapping:
          - dps_val: 4
            value: true
          - value: false

  - entity: binary_sensor
    name: Hopper Misaligned
    class: problem
    category: diagnostic
    dps:
      - id: 114
        type: bitfield
        name: sensor
        mapping:
          - dps_val: 8
            value: true
          - value: false

  - entity: binary_sensor
    name: Waste Bin Full
    class: problem
    category: diagnostic
    dps:
      - id: 114
        type: bitfield
        name: sensor
        mapping:
          - dps_val: 16
            value: true
          - value: false


  # ==================== TOILETING RECORD UNPACKING (DP 119) ====================
  # DP 119 returns a 4-byte Base64 encoded string.
  # We track the raw payload and simultaneously extract duration and weight 
  # natively inside tuya-local.

  # 1. Raw Payload (Diagnostic)
  - entity: sensor
    name: Raw Toileting Record
    category: diagnostic
    icon: "mdi:database"
    dps:
      - id: 119
        type: string
        name: sensor
        optional: true

  # 2. Decoded Duration Sensor (Visits)
  - entity: sensor
    name: Last Use Duration
    class: duration
    icon: "mdi:timer-outline"
    dps:
      - id: 119
        type: base64
        name: sensor
        mask: "FFFF0000"        # Mask first 2 bytes (Bytes 0-1)
        endianness: big
        unit: s
        precision: 0           # Force 0 decimal places
        optional: true         # <-- Added: Allows pairing when DP 119 is empty

  # 3. Decoded Weight Sensor (Kilograms)
  - entity: sensor
    name: Last Use Weight (kg)
    class: weight
    icon: "mdi:scale"          # Displays a clean weight/dial scale icon
    dps:
      - id: 119
        type: base64
        name: sensor
        mask: "0000FFFF"        # Mask final 2 bytes (Bytes 2-3)
        endianness: big
        unit: kg
        precision: 2           # Force exactly 2 decimal places
        optional: true         # <-- Added: Allows pairing when DP 119 is empty
        mapping:
          - scale: 1000         # Divides grams by 1000 to get kg

  # 4. Decoded Weight Sensor (Pounds)
  - entity: sensor
    name: Last Use Weight (lb)
    class: weight
    icon: "mdi:scale"          # Displays a clean weight/dial scale icon
    dps:
      - id: 119
        type: base64
        name: sensor
        mask: "0000FFFF"        # Mask final 2 bytes (Bytes 2-3)
        endianness: big
        unit: lb
        precision: 2           # Force exactly 2 decimal places
        optional: true         # <-- Added: Allows pairing when DP 119 is empty
        mapping:
          - scale: 453.59237    # Divides grams by 453.59237 to get lb