Skip to content

goCoax MoCA for Home Assistant

License

Notifications You must be signed in to change notification settings

homeassistant-projects/hass-gocoax

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

goCoax MoCA for Home Assistant

goCoax Logo

Sensors for monitoring goCoax MoCA adapters and the associated mesh networks.

release_badge release_date hacs_badge beta_badge License Buy Me A Coffee

Models Supported

Manufacturer Model MoCA Speed Ethernet Port Supported Known Working Firmware
goCoax MA2500D 2.5 2.5 GbE YES 2.0.11
goCoax MA2500C 2.5 2.5 GbE YES 3.0.5
goCoax WF-803M 2.5 1.0 GbE YES 1.0.12
Frontier FCA252 2.5 1.0 GbE YES
Frontier WF-803T / FCA251 2.5 1.0 GbE YES

NOTE: To ensure sensor data is properly read from the adapters, it is recommended that you update to the LATEST FIRMWARE offered by goCoax Support, or one of the firmwares listed in the above table. However, upgrading firmware MAY reset settings on the adapter.

Installation

Make sure Home Assistant Community Store (HACS) is installed. This integration is part of the default HACS store (though can also be added manually using repository: rsnodgrass/hass-gocoax)

Configuration

The goCoax MoCA unit IP address must be accessible from the Home Assistant host. Either set a static IP on the goCoax admin panel or use static DHCP assignment.

Add via the Home Assistant UI: Settings > Devices & Services > Add Integration > goCoax

  • Host: IP address of your goCoax adapter
  • Username: Admin username (default: admin)
  • Password: Admin password (default: gocoax)

Sensors

Binary Sensors

Sensor Description
Link Status MoCA network connectivity (on = connected)
Network Controller Whether this adapter is the MoCA Network Controller
Encryption Enabled MoCA privacy/encryption status

Sensors

Sensor Description
MoCA Version Protocol version (2.0, 2.5)
MAC Address Adapter's unique MAC address
IP Address Adapter's IP address
Node ID MoCA network node identifier
Network Peers Count of other adapters on the MoCA network
TX Packets Ethernet transmit packet count (with ok/bad/dropped attributes)
RX Packets Ethernet receive packet count (with ok/bad/dropped attributes)
PHY TX Rate Physical layer transmit rate to each peer (Mbps)
PHY RX Rate Physical layer receive rate from each peer (Mbps)
Frequency Band Operating frequency band (D-Low, D-High, Extended-D)
Lowest Operating Frequency LOF in MHz
Channel Count Number of bonded MoCA channels

Device Info

The following information is shown in the device details:

  • Model name
  • Firmware version
  • Configuration URL (link to adapter web UI)

Options

After initial setup, you can configure:

  • Update Interval: How often to poll the adapter (10-300 seconds, default: 30)

Future Enhancements

The following features are planned for future releases:

  • Device Tracker: Track devices on the MoCA network by MAC address
  • Configuration Options: Band selection, encryption toggle (pending API write support)
  • SNR/Power Level Sensors: Signal-to-noise ratio and power levels (pending endpoint discovery)

See Also

Contributing

Contributions are welcome! If you have a goCoax adapter and want to help improve the integration:

  1. Enable debug logging to capture raw API responses
  2. Share endpoint data (with MAC addresses redacted) to help improve parsing
  3. Report issues or submit pull requests on GitHub
logger:
  logs:
    custom_components.gocoax: debug

Support

This integration is maintained in my free time. Sponsorship directly funds new device support and faster updates.

Buy Me a Coffee

About

goCoax MoCA for Home Assistant

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages