@jjlmoya/utils-hardware 1.25.0 → 1.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/package.json +1 -1
  2. package/src/category/index.ts +3 -1
  3. package/src/entries.ts +7 -1
  4. package/src/index.ts +2 -0
  5. package/src/tests/locale_completeness.test.ts +1 -1
  6. package/src/tests/tool_validation.test.ts +1 -1
  7. package/src/tool/usbPowerBudgetCalculator/bibliography.astro +14 -0
  8. package/src/tool/usbPowerBudgetCalculator/bibliography.ts +16 -0
  9. package/src/tool/usbPowerBudgetCalculator/component.astro +266 -0
  10. package/src/tool/usbPowerBudgetCalculator/entry.ts +29 -0
  11. package/src/tool/usbPowerBudgetCalculator/i18n/de.ts +169 -0
  12. package/src/tool/usbPowerBudgetCalculator/i18n/en.ts +169 -0
  13. package/src/tool/usbPowerBudgetCalculator/i18n/es.ts +169 -0
  14. package/src/tool/usbPowerBudgetCalculator/i18n/fr.ts +169 -0
  15. package/src/tool/usbPowerBudgetCalculator/i18n/id.ts +169 -0
  16. package/src/tool/usbPowerBudgetCalculator/i18n/it.ts +169 -0
  17. package/src/tool/usbPowerBudgetCalculator/i18n/ja.ts +169 -0
  18. package/src/tool/usbPowerBudgetCalculator/i18n/ko.ts +169 -0
  19. package/src/tool/usbPowerBudgetCalculator/i18n/nl.ts +169 -0
  20. package/src/tool/usbPowerBudgetCalculator/i18n/pl.ts +169 -0
  21. package/src/tool/usbPowerBudgetCalculator/i18n/pt.ts +169 -0
  22. package/src/tool/usbPowerBudgetCalculator/i18n/ru.ts +169 -0
  23. package/src/tool/usbPowerBudgetCalculator/i18n/sv.ts +169 -0
  24. package/src/tool/usbPowerBudgetCalculator/i18n/tr.ts +169 -0
  25. package/src/tool/usbPowerBudgetCalculator/i18n/zh.ts +169 -0
  26. package/src/tool/usbPowerBudgetCalculator/index.ts +11 -0
  27. package/src/tool/usbPowerBudgetCalculator/logic.ts +81 -0
  28. package/src/tool/usbPowerBudgetCalculator/seo.astro +15 -0
  29. package/src/tool/usbPowerBudgetCalculator/ui.ts +32 -0
  30. package/src/tool/usbPowerBudgetCalculator/usb-power-budget-calculator.css +484 -0
  31. package/src/tool/webUsbSerialMonitor/bibliography.astro +15 -0
  32. package/src/tool/webUsbSerialMonitor/bibliography.ts +18 -0
  33. package/src/tool/webUsbSerialMonitor/component.astro +356 -0
  34. package/src/tool/webUsbSerialMonitor/entry.ts +30 -0
  35. package/src/tool/webUsbSerialMonitor/i18n/de.ts +241 -0
  36. package/src/tool/webUsbSerialMonitor/i18n/en.ts +241 -0
  37. package/src/tool/webUsbSerialMonitor/i18n/es.ts +241 -0
  38. package/src/tool/webUsbSerialMonitor/i18n/fr.ts +241 -0
  39. package/src/tool/webUsbSerialMonitor/i18n/id.ts +241 -0
  40. package/src/tool/webUsbSerialMonitor/i18n/it.ts +241 -0
  41. package/src/tool/webUsbSerialMonitor/i18n/ja.ts +241 -0
  42. package/src/tool/webUsbSerialMonitor/i18n/ko.ts +241 -0
  43. package/src/tool/webUsbSerialMonitor/i18n/nl.ts +241 -0
  44. package/src/tool/webUsbSerialMonitor/i18n/pl.ts +241 -0
  45. package/src/tool/webUsbSerialMonitor/i18n/pt.ts +241 -0
  46. package/src/tool/webUsbSerialMonitor/i18n/ru.ts +241 -0
  47. package/src/tool/webUsbSerialMonitor/i18n/sv.ts +241 -0
  48. package/src/tool/webUsbSerialMonitor/i18n/tr.ts +241 -0
  49. package/src/tool/webUsbSerialMonitor/i18n/zh.ts +241 -0
  50. package/src/tool/webUsbSerialMonitor/index.ts +12 -0
  51. package/src/tool/webUsbSerialMonitor/logic.ts +44 -0
  52. package/src/tool/webUsbSerialMonitor/seo.astro +16 -0
  53. package/src/tool/webUsbSerialMonitor/ui.ts +51 -0
  54. package/src/tool/webUsbSerialMonitor/web-usb-serial-monitor.css +415 -0
  55. package/src/tools.ts +3 -1
@@ -0,0 +1,169 @@
1
+ import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
2
+ import type { ToolLocaleContent } from '../../../types';
3
+ import type { UsbPowerBudgetCalculatorUI } from '../ui';
4
+ import { bibliography } from '../bibliography';
5
+
6
+ const slug = 'usb-power-budget-calculator';
7
+ const title = 'USB 전력 예산 계산기';
8
+ const description = 'USB 포트, 충전기, 허브, 케이블 또는 USB-C PD 프로필이 여유분과 케이블 전압 강하 후에 장치를 안전하게 구동할 수 있는지 확인합니다.';
9
+
10
+ const faqData = [
11
+ {
12
+ question: 'USB 포트가 내 장치에 전력을 공급할 수 있는지 어떻게 알 수 있나요?',
13
+ answer: '총 장치 와트를 USB 소스 와트와 비교한 다음, 여유분을 확보하고 케이블 전압 강하를 추정합니다. 케이블이 길거나 가늘거나 5V에서 높은 전류를 운반할 때 공칭 와트가 높게 보이더라도 설정이 실패할 수 있습니다.',
14
+ },
15
+ {
16
+ question: 'USB 전원에 케이블 길이가 왜 중요한가요?',
17
+ answer: '구리를 흐르는 전류는 전압 강하를 만듭니다. 긴 케이블과 가는 도체는 더 많은 저항을 가지므로 장치가 충전기가 제공하는 전압보다 낮은 전압을 받을 수 있습니다. 이는 Raspberry Pi 보드, 하드 드라이브, LED 스트립, 도크 및 버스 전원 허브에 특히 중요합니다.',
18
+ },
19
+ {
20
+ question: '어떤 여유분을 사용해야 하나요?',
21
+ answer: '일반 전자제품은 최소 20%, 모터, 드라이브, 라디오 또는 버스트 부하가 있는 보드는 30%를 사용하고, 어댑터 품질을 알 수 없거나 장치가 지속적으로 작동해야 하는 경우 더 많이 사용하세요.',
22
+ },
23
+ {
24
+ question: '이것이 USB-C PD 협상 테스트를 대체할 수 있나요?',
25
+ answer: '아니요. 계산기는 전기적 예산을 확인합니다. 충전기, 케이블 e-마커, 장치 또는 허브가 실제로 특정 Power Delivery 프로필을 협상하는지 확인하지 않습니다.',
26
+ },
27
+ ];
28
+
29
+ const howToData = [
30
+ { name: '소스 프로필 선택', text: '일반적인 USB 또는 USB-C PD 프로필을 선택하거나 전압과 전류를 수동으로 편집합니다.' },
31
+ { name: '케이블 설명', text: '케이블 길이와 도체 게이지를 입력합니다. 높은 AWG 번호의 가는 와이어는 더 많은 전압 강하를 유발합니다.' },
32
+ { name: '부하 추가', text: '하나의 장치 부하를 와트로 입력하고 동일한 소스를 공유하는 장치 수를 입력합니다.' },
33
+ { name: '상태 읽기', text: '상태, 케이블 강하, 최종 전압, 사용률, 여유분을 사용하여 설정이 안전한지 결정합니다.' },
34
+ ];
35
+
36
+ const faqSchema: WithContext<FAQPage> = {
37
+ '@context': 'https://schema.org',
38
+ '@type': 'FAQPage',
39
+ mainEntity: faqData.map((item) => ({
40
+ '@type': 'Question',
41
+ name: item.question,
42
+ acceptedAnswer: { '@type': 'Answer', text: item.answer },
43
+ })),
44
+ };
45
+
46
+ const howToSchema: WithContext<HowTo> = {
47
+ '@context': 'https://schema.org',
48
+ '@type': 'HowTo',
49
+ name: title,
50
+ description,
51
+ step: howToData.map((step, i) => ({
52
+ '@type': 'HowToStep',
53
+ position: i + 1,
54
+ name: step.name,
55
+ text: step.text,
56
+ })),
57
+ };
58
+
59
+ const appSchema: WithContext<SoftwareApplication> = {
60
+ '@context': 'https://schema.org',
61
+ '@type': 'SoftwareApplication',
62
+ name: title,
63
+ description,
64
+ applicationCategory: 'UtilityApplication',
65
+ operatingSystem: 'All',
66
+ offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
67
+ inLanguage: 'ko',
68
+ };
69
+
70
+ export const content: ToolLocaleContent<UsbPowerBudgetCalculatorUI> = {
71
+ slug,
72
+ title,
73
+ description,
74
+ faq: faqData,
75
+ howTo: howToData,
76
+ schemas: [faqSchema, howToSchema, appSchema],
77
+ bibliography,
78
+ seo: [
79
+ { type: 'title', text: 'USB 전력은 예산이지 라벨이 아닙니다', level: 2 },
80
+ {
81
+ type: 'paragraph',
82
+ html: '15W, 45W 또는 100W로 표시된 USB 충전기는 적절한 조건에서 소스가 제공할 수 있는 것을 설명합니다. 장치는 프로토콜 협상, 전류 제한, 케이블 저항, 커넥터 품질, 허브 손실 및 부하 스파이크 이후의 결과만 볼 수 있습니다. 이 계산기는 실용적인 전기적 질문에 초점을 맞춥니다: 케이블 강하와 여유 마진 후, 실행하려는 하드웨어에 충분한 전력이 남아 있습니까?',
83
+ },
84
+ {
85
+ type: 'stats',
86
+ items: [
87
+ { label: 'USB 2.0 기본 전류', value: '0.5 A' },
88
+ { label: '5V에서 USB-C 기본 최대', value: '3 A' },
89
+ { label: '권장 여유분', value: '20%+' },
90
+ ],
91
+ },
92
+ { type: 'title', text: '결과 해석 방법', level: 3 },
93
+ {
94
+ type: 'table',
95
+ headers: ['상태', '의미', '최선의 다음 단계'],
96
+ rows: [
97
+ ['안전', '선택한 여유분 후 부하가 소스 정격 내에 있고 추정 장치 전압이 건강하게 유지됩니다.', '설정을 사용하되 어댑터가 작거나 밀폐된 경우 열에 주의하세요.'],
98
+ ['빡빡함', '부하가 여유분 제한에 가깝거나 케이블 강하가 의미 있게 되고 있습니다.', '케이블을 줄이거나, 더 굵은 도체를 선택하거나, 부하를 줄이거나, 더 높은 전력 프로필로 이동하세요.'],
99
+ ['예산 초과', '부하가 사용 가능한 소스 전력을 초과하거나 장치 측 전압이 너무 낮을 가능성이 있습니다.', '더 강한 충전기, 전원 허브, 더 짧은 케이블 또는 더 높은 USB-C PD 전압을 협상하는 장치를 사용하세요.'],
100
+ ],
101
+ },
102
+ {
103
+ type: 'diagnostic',
104
+ variant: 'warning',
105
+ title: '와트는 충분한데 장치가 계속 재설정되는 경우',
106
+ html: '<p>시동 전류는 장치 라벨에 인쇄된 평균 와트보다 훨씬 높을 수 있습니다. 5V 전원은 동일한 와트에 대해 20V PD 프로필보다 더 빠르게 전압을 잃습니다. 더 많은 전류를 운반해야 하기 때문입니다. 많은 저가 케이블은 외부 재킷이 두꺼워 보여도 가는 전원 도체를 사용하며, 버스 전원 허브는 하나의 업스트림 예산을 모든 다운스트림 장치 간에 공유합니다.</p>',
107
+ },
108
+ { type: 'title', text: '케이블 전압 강하를 간단히 설명', level: 3 },
109
+ {
110
+ type: 'paragraph',
111
+ html: '전압 강하는 전류가 케이블 저항을 통해 흐를 때 발생하는 손실입니다. USB 전원은 전력 경로에 두 개의 도체가 있으므로 계산기는 왕복 길이를 사용합니다. 1미터 케이블은 전력 루프에 대해 전기적으로 2미터의 구리입니다. 낮은 AWG 번호가 더 굵고 일반적으로 높은 전류 부하에 더 좋습니다.',
112
+ },
113
+ {
114
+ type: 'comparative',
115
+ items: [
116
+ { title: '짧고 굵은 케이블', description: 'Raspberry Pi 보드, SSD 인클로저, 개발 키트 및 버스트 전류를 소비하는 USB-C 도크에 가장 적합합니다.' },
117
+ { title: '길고 가는 케이블', description: '저전력 센서나 느린 충전에는 허용되지만, 드라이브, LED 부하 및 컴퓨트 보드에는 위험합니다.' },
118
+ { title: '더 높은 전압 PD', description: '동일한 와트에 대해 전류를 줄여 케이블 손실을 낮추지만, 소스, 케이블 및 장치가 이를 협상하는 경우에만 해당됩니다.' },
119
+ ],
120
+ },
121
+ {
122
+ type: 'tip',
123
+ title: '실용적인 규칙',
124
+ html: '계산기가 설정이 빡빡하다고 표시하면 현장 경고로 취급하세요. USB 장애는 명확한 전원 문제로 보이기 전에 무작위 연결 끊김, 전압 저하, 느린 충전, 잡음이 있는 오디오 또는 저장 오류로 나타나는 경우가 많습니다.',
125
+ },
126
+ {
127
+ type: 'summary',
128
+ title: '이 계산기가 가장 적합한 용도',
129
+ items: [
130
+ 'USB 허브, 단일 보드 컴퓨터, 외장 드라이브, 개발 보드, 조명, 팬 및 소규모 실험실 설정 계획.',
131
+ 'USB 2.0, USB 3.x, USB-C 및 USB Power Delivery 소스 프로필 비교.',
132
+ '케이블이 부하에 비해 너무 길거나 가는지 추정.',
133
+ '충전기나 전원 허브를 구매하기 전에 적절한 여유분 선택.',
134
+ ],
135
+ },
136
+ ],
137
+ ui: {
138
+ profileLabel: 'USB 소스 프로필',
139
+ metricUnits: '미터법',
140
+ imperialUnits: 'US',
141
+ voltageLabel: '소스 전압 (V)',
142
+ currentLabel: '소스 전류 (A)',
143
+ cableLengthLabel: '케이블 길이',
144
+ wireGaugeLabel: '전원 와이어 게이지',
145
+ deviceLoadLabel: '장치당 부하 (W)',
146
+ devicesLabel: '장치',
147
+ headroomLabel: '여유분 (%)',
148
+ sourcePower: '소스 전력',
149
+ requiredPower: '필요 전력',
150
+ cableDrop: '케이블 강하',
151
+ deviceVoltage: '장치 전압',
152
+ headroom: '여유분',
153
+ utilization: '사용률',
154
+ safeStatus: '전력 예산이 안전해 보입니다',
155
+ tightStatus: '전력 예산이 빡빡합니다',
156
+ overStatus: '예산 초과 또는 전압 강하 위험',
157
+ safeAdvice: '선택한 여유분으로 부하가 맞습니다. 품질 좋은 케이블을 사용하고 장시간 실행 시 열을 확인하세요.',
158
+ tightAdvice: '한계에 가깝습니다. 케이블 길이를 줄이거나, 더 굵은 도체를 사용하거나, 부하를 낮추거나, 더 강한 프로필을 선택하세요.',
159
+ overAdvice: '이 설정은 전압 저하 또는 스로틀링이 발생할 가능성이 높습니다. 전원 허브, 더 강한 어댑터 또는 더 높은 전압 USB-C PD 프로필을 사용하세요.',
160
+ busLane: 'USB 소스',
161
+ loadLane: '장치 부하',
162
+ cableLane: '강하',
163
+ boardEyebrow: '실시간 USB 전력 경로',
164
+ sourceSocket: '공급 소켓',
165
+ deviceSocket: '하드웨어 부하',
166
+ energyFlow: '에너지 흐름',
167
+ reservedLabel: '여유분 후 사용 가능',
168
+ },
169
+ };
@@ -0,0 +1,169 @@
1
+ import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
2
+ import type { ToolLocaleContent } from '../../../types';
3
+ import type { UsbPowerBudgetCalculatorUI } from '../ui';
4
+ import { bibliography } from '../bibliography';
5
+
6
+ const slug = 'usb-vermogensbudget-calculator';
7
+ const title = 'USB Vermogensbudget Calculator';
8
+ const description = 'Controleer of een USB-poort, lader, hub, kabel of USB-C PD-profiel je apparaten veilig kan voeden na reservemarge en kabelspanningsval.';
9
+
10
+ const faqData = [
11
+ {
12
+ question: 'Hoe weet ik of een USB-poort mijn apparaat kan voeden?',
13
+ answer: 'Vergelijk het totale apparaatwattage met het USB-bronwattage, reserveer vervolgens marge en schat de kabelspanningsval. Een opstelling kan falen, zelfs wanneer het nominale wattage hoog lijkt als de kabel lang, dun of hoge stroom voert bij 5 volt.',
14
+ },
15
+ {
16
+ question: 'Waarom is kabellengte belangrijk voor USB-voeding?',
17
+ answer: 'Stroom die door koper vloeit, creëert spanningsval. Lange kabels en dunne geleiders hebben meer weerstand, dus het apparaat kan minder spanning ontvangen dan de lader levert. Dit is vooral belangrijk voor Raspberry Pi-boards, harde schijven, LED-strips, docks en busgevoede hubs.',
18
+ },
19
+ {
20
+ question: 'Welke reservemarge moet ik gebruiken?',
21
+ answer: 'Gebruik minimaal 20 procent voor normale elektronica, 30 procent voor motoren, drives, radio\'s of boards met piekbelastingen, en meer als de adapterkwaliteit onbekend is of het apparaat continu moet draaien.',
22
+ },
23
+ {
24
+ question: 'Kan dit USB-C PD-onderhandelingstests vervangen?',
25
+ answer: 'Nee. De calculator controleert het elektrische budget. Het verifieert niet of een lader, kabel-e-marker, apparaat of hub daadwerkelijk een specifiek Power Delivery-profiel onderhandelt.',
26
+ },
27
+ ];
28
+
29
+ const howToData = [
30
+ { name: 'Kies een bronprofiel', text: 'Selecteer een veelvoorkomend USB- of USB-C PD-profiel, of bewerk spanning en stroom handmatig.' },
31
+ { name: 'Beschrijf de kabel', text: 'Voer kabellengte en geleiderdikte in. Dunne draden met hoge AWG-nummers veroorzaken meer spanningsval.' },
32
+ { name: 'Voeg de belasting toe', text: 'Voer één apparaatbelasting in watt in en het aantal apparaten dat dezelfde bron deelt.' },
33
+ { name: 'Lees de status', text: 'Gebruik de status, kabelval, eindspanning, benutting en marge om te beslissen of de opstelling veilig is.' },
34
+ ];
35
+
36
+ const faqSchema: WithContext<FAQPage> = {
37
+ '@context': 'https://schema.org',
38
+ '@type': 'FAQPage',
39
+ mainEntity: faqData.map((item) => ({
40
+ '@type': 'Question',
41
+ name: item.question,
42
+ acceptedAnswer: { '@type': 'Answer', text: item.answer },
43
+ })),
44
+ };
45
+
46
+ const howToSchema: WithContext<HowTo> = {
47
+ '@context': 'https://schema.org',
48
+ '@type': 'HowTo',
49
+ name: title,
50
+ description,
51
+ step: howToData.map((step, i) => ({
52
+ '@type': 'HowToStep',
53
+ position: i + 1,
54
+ name: step.name,
55
+ text: step.text,
56
+ })),
57
+ };
58
+
59
+ const appSchema: WithContext<SoftwareApplication> = {
60
+ '@context': 'https://schema.org',
61
+ '@type': 'SoftwareApplication',
62
+ name: title,
63
+ description,
64
+ applicationCategory: 'UtilityApplication',
65
+ operatingSystem: 'All',
66
+ offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
67
+ inLanguage: 'nl',
68
+ };
69
+
70
+ export const content: ToolLocaleContent<UsbPowerBudgetCalculatorUI> = {
71
+ slug,
72
+ title,
73
+ description,
74
+ faq: faqData,
75
+ howTo: howToData,
76
+ schemas: [faqSchema, howToSchema, appSchema],
77
+ bibliography,
78
+ seo: [
79
+ { type: 'title', text: 'USB-vermogen is een budget, geen label', level: 2 },
80
+ {
81
+ type: 'paragraph',
82
+ html: 'Een USB-lader met 15 W, 45 W of 100 W beschrijft wat de bron onder de juiste omstandigheden kan bieden. Je apparaat ziet alleen het resultaat na protocolonderhandeling, stroomlimieten, kabelweerstand, connectorkwaliteit, hubverliezen en belastingspieken. Deze calculator richt zich op de praktische elektrische vraag: is er na kabelval en reservemarge genoeg vermogen over voor de hardware die je wilt gebruiken?',
83
+ },
84
+ {
85
+ type: 'stats',
86
+ items: [
87
+ { label: 'USB 2.0 standaardstroom', value: '0,5 A' },
88
+ { label: 'USB-C standaardmaximum bij 5 V', value: '3 A' },
89
+ { label: 'Aanbevolen reserve', value: '20%+' },
90
+ ],
91
+ },
92
+ { type: 'title', text: 'Hoe het resultaat te interpreteren', level: 3 },
93
+ {
94
+ type: 'table',
95
+ headers: ['Status', 'Betekenis', 'Beste volgende stap'],
96
+ rows: [
97
+ ['Veilig', 'De belasting past binnen de broncapaciteit na de gekozen reserve en de geschatte apparaatspanning blijft gezond.', 'Gebruik de opstelling, maar houd warmte in de gaten als de adapter klein of ingesloten is.'],
98
+ ['Krap', 'De belasting ligt dicht bij de gereserveerde limiet of de kabelval wordt betekenisvol.', 'Verkort de kabel, kies dikkere geleiders, verlaag de belasting of ga naar een hoger vermogensprofiel.'],
99
+ ['Over budget', 'De belasting overschrijdt het bruikbare bronvermogen of de apparaatspanning is waarschijnlijk te laag.', 'Gebruik een sterkere lader, actieve hub, kortere kabel of een apparaat dat een hogere USB-C PD-spanning onderhandelt.'],
100
+ ],
101
+ },
102
+ {
103
+ type: 'diagnostic',
104
+ variant: 'warning',
105
+ title: 'Als het wattage voldoende is maar het apparaat toch reset',
106
+ html: '<p>De startstroom kan veel hoger zijn dan het gemiddelde wattage op een apparaatlabel. Een 5 V-voeding verliest sneller spanning dan een 20 V PD-profiel voor hetzelfde wattage omdat het meer stroom moet voeren. Veel goedkope kabels gebruiken dunne stroomgeleiders, zelfs als de buitenmantel er dik uitziet, en busgevoede hubs delen één upstream-budget over elk downstream-apparaat.</p>',
107
+ },
108
+ { type: 'title', text: 'Kabelspanningsval in eenvoudige termen', level: 3 },
109
+ {
110
+ type: 'paragraph',
111
+ html: 'Spanningsval is het verlies dat ontstaat wanneer stroom door kabelweerstand vloeit. USB-voeding heeft twee geleiders in het stroompad, dus de calculator gebruikt de heen-en-teruglengte. Een kabel van één meter is elektrisch twee meter koper voor de stroomlus. Lagere AWG-nummers zijn dikker en meestal beter voor hoge stroombelastingen.',
112
+ },
113
+ {
114
+ type: 'comparative',
115
+ items: [
116
+ { title: 'Korte dikke kabel', description: 'Het beste voor Raspberry Pi-boards, SSD-behuizingen, ontwikkelingskits en USB-C-docks die piekstroom trekken.' },
117
+ { title: 'Lange dunne kabel', description: 'Acceptabel voor sensoren met laag vermogen of langzaam opladen, maar riskant voor drives, LED-belastingen en compute-boards.' },
118
+ { title: 'Hogere spanning PD', description: 'Verlaagt de stroom voor hetzelfde wattage, wat het kabelverlies vermindert, maar alleen als de bron, kabel en apparaat dit onderhandelen.' },
119
+ ],
120
+ },
121
+ {
122
+ type: 'tip',
123
+ title: 'Praktische regel',
124
+ html: 'Als de calculator zegt dat de opstelling krap is, behandel het dan als een veldwaarschuwing. USB-storingen verschijnen vaak als willekeurige verbroken verbindingen, onderspanningsuitval, langzaam opladen, ruis in audio of opslagfouten voordat ze eruitzien als een duidelijk stroomprobleem.',
125
+ },
126
+ {
127
+ type: 'summary',
128
+ title: 'Waar deze calculator het beste voor is',
129
+ items: [
130
+ 'Het plannen van USB-hubs, single-board computers, externe drives, ontwikkelborden, lampen, ventilatoren en kleine labopstellingen.',
131
+ 'Het vergelijken van USB 2.0-, USB 3.x-, USB-C- en USB Power Delivery-bronprofielen.',
132
+ 'Inschatten of een kabel te lang of te dun is voor een belasting.',
133
+ 'Een verstandige reserve kiezen voordat je een lader of actieve hub koopt.',
134
+ ],
135
+ },
136
+ ],
137
+ ui: {
138
+ profileLabel: 'USB-bronprofiel',
139
+ metricUnits: 'Metriek',
140
+ imperialUnits: 'US',
141
+ voltageLabel: 'Bronspanning (V)',
142
+ currentLabel: 'Bronstroom (A)',
143
+ cableLengthLabel: 'Kabellengte',
144
+ wireGaugeLabel: 'Stroomdraaddikte',
145
+ deviceLoadLabel: 'Belasting per apparaat (W)',
146
+ devicesLabel: 'Apparaten',
147
+ headroomLabel: 'Reserve (%)',
148
+ sourcePower: 'Bronvermogen',
149
+ requiredPower: 'Benodigd vermogen',
150
+ cableDrop: 'Kabelval',
151
+ deviceVoltage: 'Apparaatspanning',
152
+ headroom: 'Reserve',
153
+ utilization: 'Benutting',
154
+ safeStatus: 'Vermogensbudget ziet er veilig uit',
155
+ tightStatus: 'Vermogensbudget is krap',
156
+ overStatus: 'Over budget of risico op spanningsval',
157
+ safeAdvice: 'De belasting past met de gekozen reserve. Gebruik een kwaliteitskabel en controleer warmte tijdens lange gebruiksperiodes.',
158
+ tightAdvice: 'Je zit dicht bij de limiet. Verkort de kabellengte, gebruik dikkere geleiders, verlaag de belasting of kies een sterker profiel.',
159
+ overAdvice: 'Deze opstelling zal waarschijnlijk spanningsdaling of throttling ervaren. Gebruik een actieve hub, sterkere adapter of een USB-C PD-profiel met hogere spanning.',
160
+ busLane: 'USB-bron',
161
+ loadLane: 'Apparaatbelasting',
162
+ cableLane: 'val',
163
+ boardEyebrow: 'Live USB-stroompad',
164
+ sourceSocket: 'Voedingsaansluiting',
165
+ deviceSocket: 'Hardwarebelasting',
166
+ energyFlow: 'energiestroom',
167
+ reservedLabel: 'bruikbaar na reserve',
168
+ },
169
+ };
@@ -0,0 +1,169 @@
1
+ import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
2
+ import type { ToolLocaleContent } from '../../../types';
3
+ import type { UsbPowerBudgetCalculatorUI } from '../ui';
4
+ import { bibliography } from '../bibliography';
5
+
6
+ const slug = 'kalkulator-budzetu-zasilania-usb';
7
+ const title = 'Kalkulator Budżetu Zasilania USB';
8
+ const description = 'Sprawdź, czy port USB, ładowarka, hub, kabel lub profil USB-C PD może bezpiecznie zasilać Twoje urządzenia po uwzględnieniu marginesu rezerwy i spadku napięcia na kablu.';
9
+
10
+ const faqData = [
11
+ {
12
+ question: 'Skąd mam wiedzieć, czy port USB może zasilić moje urządzenie?',
13
+ answer: 'Porównaj całkowitą moc urządzenia z mocą źródła USB, uwzględnij margines bezpieczeństwa i oszacuj spadek napięcia na kablu. Konfiguracja może zawieść, nawet gdy nominalna moc wygląda na wysoką, jeśli kabel jest długi, cienki lub przewodzi wysoki prąd przy 5 woltach.',
14
+ },
15
+ {
16
+ question: 'Dlaczego długość kabla ma znaczenie przy zasilaniu USB?',
17
+ answer: 'Prąd płynący przez miedź powoduje spadek napięcia. Długie kable i cienkie przewodniki mają większą rezystancję, więc urządzenie może otrzymać niższe napięcie niż zapewnia ładowarka. Jest to szczególnie ważne w przypadku płytek Raspberry Pi, dysków twardych, taśm LED, stacji dokujących i hubów zasilanych z magistrali.',
18
+ },
19
+ {
20
+ question: 'Jaki margines rezerwy powinienem zastosować?',
21
+ answer: 'Użyj co najmniej 20 procent dla normalnej elektroniki, 30 procent dla silników, napędów, radiotelefonów lub płytek z obciążeniami impulsowymi, a więcej, jeśli jakość adaptera jest nieznana lub urządzenie musi działać nieprzerwanie.',
22
+ },
23
+ {
24
+ question: 'Czy może to zastąpić testy negocjacji USB-C PD?',
25
+ answer: 'Nie. Kalkulator sprawdza budżet elektryczny. Nie weryfikuje, czy ładowarka, e-marker kabla, urządzenie lub hub rzeczywiście negocjują określony profil Power Delivery.',
26
+ },
27
+ ];
28
+
29
+ const howToData = [
30
+ { name: 'Wybierz profil źródła', text: 'Wybierz typowy profil USB lub USB-C PD lub ręcznie edytuj napięcie i prąd.' },
31
+ { name: 'Opisz kabel', text: 'Wprowadź długość kabla i przekrój przewodu. Cienkie przewody o wysokim AWG powodują większy spadek napięcia.' },
32
+ { name: 'Dodaj obciążenie', text: 'Wprowadź obciążenie jednego urządzenia w watach i liczbę urządzeń współdzielących to samo źródło.' },
33
+ { name: 'Odczytaj status', text: 'Użyj statusu, spadku na kablu, napięcia końcowego, wykorzystania i marginesu, aby zdecydować, czy konfiguracja jest bezpieczna.' },
34
+ ];
35
+
36
+ const faqSchema: WithContext<FAQPage> = {
37
+ '@context': 'https://schema.org',
38
+ '@type': 'FAQPage',
39
+ mainEntity: faqData.map((item) => ({
40
+ '@type': 'Question',
41
+ name: item.question,
42
+ acceptedAnswer: { '@type': 'Answer', text: item.answer },
43
+ })),
44
+ };
45
+
46
+ const howToSchema: WithContext<HowTo> = {
47
+ '@context': 'https://schema.org',
48
+ '@type': 'HowTo',
49
+ name: title,
50
+ description,
51
+ step: howToData.map((step, i) => ({
52
+ '@type': 'HowToStep',
53
+ position: i + 1,
54
+ name: step.name,
55
+ text: step.text,
56
+ })),
57
+ };
58
+
59
+ const appSchema: WithContext<SoftwareApplication> = {
60
+ '@context': 'https://schema.org',
61
+ '@type': 'SoftwareApplication',
62
+ name: title,
63
+ description,
64
+ applicationCategory: 'UtilityApplication',
65
+ operatingSystem: 'All',
66
+ offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
67
+ inLanguage: 'pl',
68
+ };
69
+
70
+ export const content: ToolLocaleContent<UsbPowerBudgetCalculatorUI> = {
71
+ slug,
72
+ title,
73
+ description,
74
+ faq: faqData,
75
+ howTo: howToData,
76
+ schemas: [faqSchema, howToSchema, appSchema],
77
+ bibliography,
78
+ seo: [
79
+ { type: 'title', text: 'Zasilanie USB to budżet, nie etykieta', level: 2 },
80
+ {
81
+ type: 'paragraph',
82
+ html: 'Ładowarka USB oznaczona jako 15 W, 45 W lub 100 W opisuje, co źródło może zaoferować w odpowiednich warunkach. Twoje urządzenie widzi tylko wynik po negocjacji protokołu, limitach prądowych, rezystancji kabla, jakości złącza, stratach w hubie i skokach obciążenia. Ten kalkulator koncentruje się na praktycznym pytaniu elektrycznym: po spadku na kablu i marginesie rezerwy, czy pozostało wystarczająco dużo mocy dla sprzętu, który chcesz uruchomić?',
83
+ },
84
+ {
85
+ type: 'stats',
86
+ items: [
87
+ { label: 'Prąd domyślny USB 2.0', value: '0,5 A' },
88
+ { label: 'Maksimum domyślne USB-C przy 5 V', value: '3 A' },
89
+ { label: 'Zalecana rezerwa', value: '20%+' },
90
+ ],
91
+ },
92
+ { type: 'title', text: 'Jak interpretować wynik', level: 3 },
93
+ {
94
+ type: 'table',
95
+ headers: ['Status', 'Znaczenie', 'Najlepszy następny krok'],
96
+ rows: [
97
+ ['Bezpieczny', 'Obciążenie mieści się w mocy źródła po wybranej rezerwie, a szacowane napięcie urządzenia pozostaje prawidłowe.', 'Używaj konfiguracji, ale zwracaj uwagę na ciepło, jeśli adapter jest mały lub zabudowany.'],
98
+ ['Napięty', 'Obciążenie jest blisko limitu z rezerwą lub spadek na kablu staje się znaczący.', 'Skróć kabel, wybierz grubsze przewody, zmniejsz obciążenie lub przejdź na wyższy profil mocy.'],
99
+ ['Przekroczony budżet', 'Obciążenie przekracza użyteczną moc źródła lub napięcie po stronie urządzenia jest prawdopodobnie zbyt niskie.', 'Użyj mocniejszej ładowarki, aktywnego huba, krótszego kabla lub urządzenia negocjującego wyższe napięcie USB-C PD.'],
100
+ ],
101
+ },
102
+ {
103
+ type: 'diagnostic',
104
+ variant: 'warning',
105
+ title: 'Gdy waty są wystarczające, ale urządzenie wciąż się resetuje',
106
+ html: '<p>Prąd rozruchowy może być znacznie wyższy niż średnia moc wydrukowana na etykiecie urządzenia. Zasilacz 5 V traci napięcie szybciej niż profil PD 20 V dla tej samej mocy, ponieważ musi przewodzić więcej prądu. Wiele tanich kabli używa cienkich przewodów zasilających, nawet gdy zewnętrzna powłoka wygląda solidnie, a huby zasilane z magistrali dzielą jeden budżet upstream na wszystkie urządzenia downstream.</p>',
107
+ },
108
+ { type: 'title', text: 'Spadek napięcia na kablu w prostych słowach', level: 3 },
109
+ {
110
+ type: 'paragraph',
111
+ html: 'Spadek napięcia to strata powstająca, gdy prąd płynie przez rezystancję kabla. Zasilanie USB ma dwa przewody w ścieżce zasilania, więc kalkulator używa długości w obie strony. Kabel o długości jednego metra to elektrycznie dwa metry miedzi dla pętli zasilania. Niższe numery AWG są grubsze i zazwyczaj lepsze dla obciążeń o wysokim prądzie.',
112
+ },
113
+ {
114
+ type: 'comparative',
115
+ items: [
116
+ { title: 'Krótki gruby kabel', description: 'Najlepszy dla płytek Raspberry Pi, obudów SSD, zestawów deweloperskich i stacji dokujących USB-C pobierających prąd impulsowy.' },
117
+ { title: 'Długi cienki kabel', description: 'Akceptowalny dla czujników niskiej mocy lub powolnego ładowania, ale ryzykowny dla napędów, obciążeń LED i płytek obliczeniowych.' },
118
+ { title: 'Wyższe napięcie PD', description: 'Zmniejsza prąd dla tej samej mocy, co obniża straty na kablu, ale tylko jeśli źródło, kabel i urządzenie to negocjują.' },
119
+ ],
120
+ },
121
+ {
122
+ type: 'tip',
123
+ title: 'Praktyczna zasada',
124
+ html: 'Jeśli kalkulator mówi, że konfiguracja jest napięta, potraktuj to jako ostrzeżenie terenowe. Awarie USB często pojawiają się jako losowe rozłączenia, spadki napięcia, wolne ładowanie, zaszumiony dźwięk lub błędy pamięci masowej, zanim wyglądają jak oczywisty problem z zasilaniem.',
125
+ },
126
+ {
127
+ type: 'summary',
128
+ title: 'Do czego ten kalkulator nadaje się najlepiej',
129
+ items: [
130
+ 'Planowanie hubów USB, komputerów jednopłytkowych, napędów zewnętrznych, płytek deweloperskich, świateł, wentylatorów i małych zestawów laboratoryjnych.',
131
+ 'Porównywanie profili źródłowych USB 2.0, USB 3.x, USB-C i USB Power Delivery.',
132
+ 'Szacowanie, czy kabel jest zbyt długi lub zbyt cienki dla danego obciążenia.',
133
+ 'Wybór rozsądnej rezerwy przed zakupem ładowarki lub aktywnego huba.',
134
+ ],
135
+ },
136
+ ],
137
+ ui: {
138
+ profileLabel: 'Profil źródła USB',
139
+ metricUnits: 'Metryczne',
140
+ imperialUnits: 'US',
141
+ voltageLabel: 'Napięcie źródła (V)',
142
+ currentLabel: 'Prąd źródła (A)',
143
+ cableLengthLabel: 'Długość kabla',
144
+ wireGaugeLabel: 'Przekrój przewodu zasilającego',
145
+ deviceLoadLabel: 'Obciążenie na urządzenie (W)',
146
+ devicesLabel: 'Urządzenia',
147
+ headroomLabel: 'Margines rezerwy (%)',
148
+ sourcePower: 'Moc źródła',
149
+ requiredPower: 'Wymagana moc',
150
+ cableDrop: 'Spadek na kablu',
151
+ deviceVoltage: 'Napięcie urządzenia',
152
+ headroom: 'Rezerwa',
153
+ utilization: 'Wykorzystanie',
154
+ safeStatus: 'Budżet zasilania wygląda bezpiecznie',
155
+ tightStatus: 'Budżet zasilania jest napięty',
156
+ overStatus: 'Przekroczony budżet lub ryzyko spadku napięcia',
157
+ safeAdvice: 'Obciążenie mieści się z wybranym marginesem. Używaj kabla dobrej jakości i sprawdzaj ciepło podczas długiej pracy.',
158
+ tightAdvice: 'Jesteś blisko limitu. Zmniejsz długość kabla, użyj grubszych przewodów, zmniejsz obciążenie lub wybierz mocniejszy profil.',
159
+ overAdvice: 'Ta konfiguracja prawdopodobnie będzie doświadczać spadków napięcia lub dławienia. Użyj aktywnego huba, mocniejszego adaptera lub profilu USB-C PD o wyższym napięciu.',
160
+ busLane: 'Źródło USB',
161
+ loadLane: 'Obciążenie urządzenia',
162
+ cableLane: 'spadek',
163
+ boardEyebrow: 'Ścieżka zasilania USB na żywo',
164
+ sourceSocket: 'Gniazdo zasilania',
165
+ deviceSocket: 'Obciążenie sprzętowe',
166
+ energyFlow: 'przepływ energii',
167
+ reservedLabel: 'dostępne po rezerwie',
168
+ },
169
+ };