Home Assistant 卡片分享(十一)福特派爱车卡片:车况、胎压、门窗与远程控车一屏搞定
上一篇写的是鱼缸卡片,这篇换四个轮子。
我一直想把福特派的车况接进 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. 三个间距坑(踩完才对齐)
卡片刚做完时上下两排间距明显不一样,量了一遍坐标才明白问题出在哪:
type: grid的列间距默认约 25px,而horizontal-stack是 8px。要在 grid 卡上补一句#root { column-gap: 8px !important; },两排才是一个比例。grid 的行轨道是 88px、里面的卡片只有 84px,多出的 4px 会变成视觉行距(8+4=12px)。把卡片高度改成 88px 填满轨道,行距才是真的 8px。
想给卡片加下边距时,在
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 的哈希,不要手写猜,去「设置 → 设备与服务 → 实体」按中文名复制。
自定义扩展思路
胎压告警:拿「胎压系统状态」做自动化,异常时推送到手机,比天天看卡片靠谱。
机油寿命趋势:
mini-graph-card读机油寿命,配合集成给的「机油归零预计日期」,提前一个月提醒保养。后备箱 / 鸣笛:集成还有
button.xxx_unlock_trunk等按钮,加到控制行当第 5 个按钮即可。回家自动预热:定位进入小区范围 + 气温低于 5℃,自动下发远程启动,冬天上车就有暖风。
写在最后
这套卡片最花时间的其实不是样式,而是那几个像素级的间距。毛玻璃卡片一旦对不齐,整块面板的精致感就没了——所以别怕量坐标,量一次比调十次靠谱。
另外提醒一句:远程控车类按钮一定要加二次确认,尤其是解锁和远程启动。点错一个灯最多是灯亮了,点错一次车门可就不是小事了。
Happy automating! 🚗