上一篇写的是鱼缸卡片,这篇换四个轮子。

我一直想把福特派的车况接进 Home Assistant。社区里那个老集成早就不维护了——福特中国的接口在 2023 年改过一轮认证,装上去能登录、却拿不到任何实体。最近换成了仍在维护的 RockJesus/ha-fordpass-cn,一次就把车接上了:续航、油量、总里程、机油寿命、四轮胎压、四门四窗,还有远程启动和上锁解锁。代价是默认丢出来八十多个实体,全铺在面板上实在没法看,于是有了这套卡片。

风格还是老朋友:毛玻璃 + button-card,和我前面几篇卡片保持一套视觉语言。


🎨卡片预览

整张卡片从上到下分四段:

  • 主视觉卡:车型图 + 车牌 + 在线 / 熄火 / 上锁三枚状态胶囊,底部一行「车况几分钟前 + 当前位置」。

  • 数据区:续航、燃油、总里程、机油寿命,2×2 排布。

  • 车况区:四轮胎压(按推荐值自动变色)+ 四门四窗八个开关状态。

  • 控制区:锁车、解锁、远程启动、刷新车况。

截图里的车牌和定位我打了码,其余都是车机真实上报的数据。

福特派卡片-桌面

手机窄屏下是同一张卡片,列宽变窄后 2×2 会自动收窄,不会出现文字被截断或者单位被挤掉:

福特派卡片-手机

卡片详解

1. 主视觉卡:把车型图当背景

福特派云端本身就带一张 45° 车型图(透明底),直接拿来当卡片的 CSS 背景,再叠一层从左到右的渐变把左侧压暗,文字就不会糊在车身上:

styles:
  card:
    - height: 200px
    - border-radius: 16px
    - background: >-
        linear-gradient(90deg, rgba(22,27,34,0.95) 0%, rgba(22,27,34,0.86) 38%,
                        rgba(22,27,34,0.15) 60%, rgba(22,27,34,0) 76%),
        url('/local/ford/edge.png') right 8px center / 46% auto no-repeat,
        rgba(255,255,255,0.05)

车型图我用的是福特派云端那张(集成会把它缓存在本地,实体 image.xxx_side_vehicle_view 的 image_url 属性里就是原始地址);想彻底本地化,就把它下载到 www/ford/edge.png,再把 URL 换成 /local/ford/edge.png。

注意 / 46% auto 这个尺寸。一开始我按 62% 铺满,车顶直接顶到卡片上边缘,看着像被裁掉了一块,收到 46% 才留出呼吸感。

状态胶囊是在 custom_fields 里拼出来的 HTML,颜色跟着实体状态走:

const pil = (txt, color) => `<span style="padding:3px 9px;border-radius:999px;
  background:${color}22;border:1px solid ${color}55;color:${color};font-size:11px">${txt}</span>`;

// 在线 / 熄火 / 锁车 三枚胶囊
pil(online === '在线' ? '在线' : '离线', online === '在线' ? '#4CAF50' : '#9E9E9E')
pil(running ? '发动机运转' : '已熄火', running ? '#FFC107' : '#8b95a3')
pil(locked ? '已上锁' : '已解锁', locked ? '#4CAF50' : '#FF3B30')

2. 数据卡:数值右对齐

四张数据卡用 type: grid + columns: 2 排 2×2,每张卡「图标 + 名称在左、数值靠右」:

grid:
  - grid-template-areas: '"i n val"'
  - grid-template-columns: 36px minmax(0,1fr) auto
  - grid-template-rows: 1fr
custom_fields:
  val:
    - justify-self: end
    - align-self: center

minmax(0,1fr) 那一段别省。中间列不写死最小宽度,像 61,091 km 这种长数字才不会把单位顶出卡片外面。

3. 胎压卡:按推荐值自动配色

集成同时给了四轮胎压和「推荐胎压」,按比例上色就行,低于 95% 变黄、低于 85% 变红,一眼就能看出哪条胎该打气:

const r = v / rec;                     // v=当前胎压, rec=推荐胎压
const c = r >= 0.95 ? '#4CAF50'
        : (r >= 0.85 ? '#FFC107' : '#FF3B30');

我车四轮都在 204–213 kPa,推荐 241,所以截图里是一片红黄——不是卡片坏了,是真的该去加气了。

4. 门窗卡:八个图标一眼看完

四个门 + 四个窗,在 custom_fields 里用 ha-icon 画一个 4×2 网格,已关闭 绿、未关紧 红、其他黄。比列八行实体省一半高度,也更容易扫读。

const ok = st.indexOf('已关闭') >= 0;
const c = ok ? '#4CAF50' : (st.indexOf('未关紧') >= 0 ? '#FF3B30' : '#FFC107');
`<ha-icon icon="mdi:car-door" style="color:${c};--mdc-icon-size:20px"></ha-icon>`

5. 刷新按钮:真进度,不是假动画

福特派的状态是车机定时上报的,云端同步本身就有延迟(官方 App 一样),着急用车时得手动刷一下。集成提供了 button.xxx_refresh_vehicle_status,但按下之后要 30–60 秒车机才回数据——按钮如果没有反馈,人就会连着点好几次。

做法是拿两个时间比大小:button 实体的 last_command(我按下的时刻)和 sensor.xxx_vehicle_data_last_updated(车机最后一次上报的时刻)。只有「车机时间 ≥ 按下时间」才算真的刷新完成:

const cmd = new Date(btn.attributes.last_command).getTime();
const upd = new Date(updEntity.state).getTime();

if (cmd && Date.now() - cmd < 120000 && upd < cmd) return '刷新中…';
if (cmd && upd >= cmd) return Math.round((Date.now() - cmd) / 60000) + ' 分钟前刷新';
return '点我同步云端';

图标同时换成琥珀色并旋转(@keyframes 写在 extra_styles 里),车机数据一回来就自动恢复青色。实测按下 35 秒后车机数据时间会前进,按钮文案也跟着变,不会出现「点了没反应」的错觉。

6. 三个间距坑(踩完才对齐)

卡片刚做完时上下两排间距明显不一样,量了一遍坐标才明白问题出在哪:

  1. type: grid 的列间距默认约 25px,而 horizontal-stack 是 8px。要在 grid 卡上补一句 #root { column-gap: 8px !important; },两排才是一个比例。

  2. grid 的行轨道是 88px、里面的卡片只有 84px,多出的 4px 会变成视觉行距(8+4=12px)。把卡片高度改成 88px 填满轨道,行距才是真的 8px。

  3. 想给卡片加下边距时,在 button-card 上写 styles.card.margin-top 是无效的——stack 里的子卡会被拉伸,margin 变成卡片自己变高。要在 grid 卡上用 :host { display: block; margin-bottom: 8px; }。

7. 语音控制(可选)

顺手把小爱接上了:「小爱同学,启动福特」就远程着车。触发用小爱音箱的 conversation 传感器——监听 timestamp 属性而不是 content,否则同一句话说两遍不会触发;条件里匹配「福特 / 伏特」+「启动 / 热车」,并加一个 40 秒新鲜度窗口,防止历史句子被重复执行。动作就是 switch.turn_on 远程启动,然后等 90 秒看车机有没有真的变「运转中」,再让音箱回一句结果。

triggers:
  - trigger: state
    entity_id: [sensor.xiaomi_lx06_ac65_conversation]
    attribute: timestamp
conditions:
  - condition: template
    value_template: >
      {% set c = state_attr(trigger.entity_id, 'content') | string %}
      {% set msg_ts = as_timestamp(state_attr(trigger.entity_id, 'timestamp'), default=0) %}
      {{ ('福特' in c or '伏特' in c) and ('启动' in c or '热车' in c)
         and '关' not in c and '熄' not in c and '取消' not in c
         and msg_ts > 0 and (as_timestamp(now()) - msg_ts) < 40 }}

安装与依赖

  • 集成:RockJesus/ha-fordpass-cn,已收录在 HACS 默认源,搜「福特派」或「林肯之道」直接装。登录用手机号短信验证码,不用再去抓包找 refresh_token;令牌会自动续期。

  • 前端卡片:button-card、card-mod(这里只用到一处 #root 覆盖)。

两个提醒:集成是按车型云端能力创建实体的,纯燃油车不会冒出充电相关实体,属正常;实体 ID 前缀是 VIN 的哈希,不要手写猜,去「设置 → 设备与服务 → 实体」按中文名复制。


自定义扩展思路

  1. 胎压告警:拿「胎压系统状态」做自动化,异常时推送到手机,比天天看卡片靠谱。

  2. 机油寿命趋势:mini-graph-card 读机油寿命,配合集成给的「机油归零预计日期」,提前一个月提醒保养。

  3. 后备箱 / 鸣笛:集成还有 button.xxx_unlock_trunk 等按钮,加到控制行当第 5 个按钮即可。

  4. 回家自动预热:定位进入小区范围 + 气温低于 5℃,自动下发远程启动,冬天上车就有暖风。


写在最后

这套卡片最花时间的其实不是样式,而是那几个像素级的间距。毛玻璃卡片一旦对不齐,整块面板的精致感就没了——所以别怕量坐标,量一次比调十次靠谱。

另外提醒一句:远程控车类按钮一定要加二次确认,尤其是解锁和远程启动。点错一个灯最多是灯亮了,点错一次车门可就不是小事了。

Happy automating! 🚗