Change the electrical project
edit_electricalAssign electrical circuits and voltage, route power/data/TV cables, and compute cable lengths and materials for telecom and electrical projects.
Instructions
Change the electrical and telecom project (the electrical tool reads it: check, circuits, wifi). assign {ids, circuit, va?} — or the whole division at once, circuits {"C1": [ids], "C2": [ids]} — writes the circuits (and power, and volts 127|220 per point — a 220 V outlet makes its circuit 220 V) on points in one undoable step. voltage {volts?, short_ka?, earthing?: TN-S|TN-C-S|TT}. cable {kind: power|data|tv, pts} (with ids or circuit instead of pts, it is a route): draws a run of the electrical project, told apart on the plan (power solid, network dashed, TV dash-dot); check then reports cables_m, the length by kind with a tenth for the drops, and network or TV points no run reaches, or a telecom panel none reaches. route {kind: power|data|tv, ids? | circuit?, via?: ceiling|floor|wall|tape, cat?: cat5e|cat6|cat6a, from?}: lays the run the way it is built, along the walls and inside them (or in the slab), from the nearest panel of its kind to the points (all of the kind when none given), sharing the trunk, and draws it replacing the earlier run of the same circuit and the cables drawn by hand to its points (listed in replaced_drawn); replies {via, suggested, length_m {horizontal, vertical, total}, by_premise_m, bends, materials: [[item, qty, unit]]} — conduit, boxes, wire by conductor, cable, connectors. via=tape lays adhesive flat wiring tape (Eletrofitas) on the surface of walls and ceiling for power only: the model by the load and whether any point is a socket (sockets take the earthed EF18.9.18), refused over its rating or in a bathroom or outdoors, bought as Leroy Merlin kits by piece (codes, prices, splices) with tape {model, tracks, rated_a, load_a, earthed, pieces_m, splices, total_brl, notes}. Without via it takes the cheapest premise that can be built; a via that cannot reach a point (wall with a point out of every wall; ceiling with a low point out of every wall, nowhere to drop) is refused naming the points. wifi {ids, standard?, poe?, uplink?, bands?} writes those on the access points (wifi-point), in one undoable step. assign on automation points takes standby_w, on a dimmer max_w, on a panel modules.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| va | No | Power per point, VA, instead of the norm's default | |
| cat | No | For `route` of data: `cat5e`, `cat6` (default) or `cat6a` | |
| ids | No | Point ids for `assign` | |
| poe | No | For `wifi`: whether `ids` are fed by their data cable (`PoE`) | |
| pts | No | For `cable`: the run's points `[[x,y], …]`, cm | |
| via | No | For `route`: where the run passes, `ceiling` (slab, dropping in the walls), `floor` or `wall`. Omitted: the cheapest that can be built | |
| band | No | For `wifi`: the band the suggestion aims at, `2.4`, `5` (default) or `6` | |
| from | No | For `route`: the panel it starts from; default the nearest of its kind | |
| kind | No | For `cable`: what the run carries, `power`, `data` or `tv` | |
| bands | No | For `wifi`: the bands they radiate when fewer than their generation's, e.g. `2.4,5` for a dual-band Wi-Fi 7 | |
| max_w | No | For `assign` on a dimmer: the most lighting it takes, W | |
| volts | No | Supply voltage, V; with `assign`, the points' own, 127 or 220 | |
| action | No | `assign`: put `ids` on `circuit` (empty takes them off), with `va` to set their power; `voltage`: the supply, 127 or 220 V; `cable`, `route` or `wifi` | |
| uplink | No | For `wifi`: the access points' wired uplink, Gbps (1, 2.5, 5, 10) | |
| circuit | No | Circuit name, e.g. `C3` | |
| modules | No | For `assign` on a distribution panel: the DIN modules it holds | |
| circuits | No | For `assign`: the whole division at once, `{"C1": [ids], "C2": [ids]}`, in one undoable step | |
| earthing | No | For `voltage`: the earthing scheme, `TN-S`, `TN-C-S` or `TT` | |
| short_ka | No | For `voltage`: the presumed short-circuit current at the delivery point, kA, as the utility informs it | |
| standard | No | For `wifi`: the access points' standard, `wifi5`, `wifi6`, `wifi6e` or `wifi7`, written on `ids` | |
| standby_w | No | For `assign` on automation points: standby consumption, W |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| v | No | Plan version written to, when there are several | |
| ok | No | Always true | |
| ids | No | Ids created or touched | |
| rev | No | Plan revision | |
| run | No | The run: <system>:<circuit|all|ids> | |
| via | No | Where it runs: ceiling, floor, wall (or tape) | |
| gone | No | Ids removed, or their count | |
| tape | No | via=tape: the tape light system | |
| text | No | The reply as written | |
| added | No | Ids added, or their count | |
| bends | No | Bends along the run | |
| changed | No | {id, from, to} per element changed; a count past 20 | |
| coverage | No | action=wifi: [room, band, median, worst, good, grade] | |
| length_m | No | Metres: {horizontal, vertical, total} | |
| warnings | No | Data points past 90 m | |
| materials | No | Bill of materials: [item, quantity, unit] | |
| suggested | No | Route: the one the rules suggest; action=wifi: where access points would go | |
| properties | No | Project properties changed | |
| annotations | No | Annotation switches {from, to} | |
| by_premise_m | No | Total metres by route: {ceiling, floor, wall}; a reason instead where one is impossible | |
| access_points | No | action=wifi: [id, standard, bands, uplink] | |
| replaced_drawn | No | Hand-drawn lines this run replaced |