SystemDoctor/V2GProtocol_CSharp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Refactor helper functions to separate Helper class and translate comments to Korean

Browse Source 
- Extract hex conversion functions to new Helper.cs file
- Remove duplicate helper functions from Program.cs and V2GDecoder.cs
- Update all references to use Helper class
- Translate all comments in Program.cs to Korean
- Improve code organization and reusability

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
tindevil
2025-09-07 20:08:45 +09:00
parent e09c63080e
commit 7ba42fe215
3 changed files with 83 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
Helper.cs Normal file
View File

@@ -0,0 +1,38 @@
using System;
namespace V2GProtocol
{
/// <summary>
/// 헥스 문자열 변환 헬퍼 클래스
/// </summary>
public static class Helper
{
/// <summary>
/// 헥스 문자열을 바이트 배열로 변환
/// </summary>
/// <param name="hexString">헥스 문자열</param>
/// <returns>바이트 배열</returns>
public static byte[] FromHexString(string hexString)
{
if (hexString.Length % 2 != 0)
throw new ArgumentException("Invalid hex string length");
byte[] bytes = new byte[hexString.Length / 2];
for (int i = 0; i < bytes.Length; i++)
{
bytes[i] = Convert.ToByte(hexString.Substring(i * 2, 2), 16);
}
return bytes;
}
/// <summary>
/// 바이트 배열을 헥스 문자열로 변환
/// </summary>
/// <param name="bytes">바이트 배열</param>
/// <returns>헥스 문자열</returns>
public static string ToHexString(byte[] bytes)
{
return BitConverter.ToString(bytes).Replace("-", "");
}
}
}

105
Program.cs
View File

@@ -7,26 +7,9 @@ namespace V2GProtocol
{
class Program
{
static byte[] FromHexString(string hexString)
{
if (hexString.Length % 2 != 0)
throw new ArgumentException("Invalid hex string length");
byte[] bytes = new byte[hexString.Length / 2];
for (int i = 0; i < bytes.Length; i++)
{
bytes[i] = Convert.ToByte(hexString.Substring(i * 2, 2), 16);
}
return bytes;
}
static string ToHexString(byte[] bytes)
{
return BitConverter.ToString(bytes).Replace("-", "");
}
static void Main(string[] args)
{
// Only show header for help or analysis mode (not for encode/decode operations)
// 헤더는 도움말 또는 분석 모드에서만 표시 (인코드/디코드 작업에서는 표시하지 않음)
bool showHeader = false;
if (args.Length == 0)
@@ -37,18 +20,18 @@ namespace V2GProtocol
{
string firstArg = args[0].ToLower();
// Check if it's help command
// 도움말 명령인지 확인
if (firstArg == "--help" || firstArg == "-h")
{
showHeader = true;
}
// Check if it's a file for analysis mode (only .dump/.txt without options)
// 분석 모드용 파일인지 확인 (옵션 없이 .dump/.txt만)
else if (File.Exists(args[0]) && args.Length == 1)
{
string extension = Path.GetExtension(args[0]).ToLower();
// Only show header for analysis mode (.dump/.txt)
// NOT for auto-conversion (.hex, .xml)
// 분석 모드에서만 헤더 표시 (.dump/.txt)
// 자동 변환에서는 표시하지 않음 (.hex, .xml)
if (extension == ".dump" || extension == ".txt")
{
showHeader = true;
@@ -118,35 +101,35 @@ namespace V2GProtocol
// 파일명만 전달된 경우 (분석 모드)
else if (File.Exists(args[0]))
{
// Check file extension to determine default action
// 파일 확장자를 확인하여 기본 동작 결정
string extension = Path.GetExtension(args[0]).ToLower();
if (extension == ".dump" || extension == ".txt")
{
// Hex dump files - use full analysis mode
// 헥스 덤프 파일 - 전체 분석 모드 사용
AnalyzeFile(args[0]);
}
else if (extension == ".hex")
{
// .hex files - automatically decode to XML
// .hex 파일 - 자동으로 XML로 디코드
var autoArgs = new List<string> { "--decode", args[0] };
// Add remaining args (like -out)
// 나머지 인자 추가 (-out 등)
for (int i = 1; i < args.Length; i++)
autoArgs.Add(args[i]);
HandleDecodeCommand(autoArgs.ToArray());
}
else if (extension == ".xml")
{
// .xml files - automatically encode to EXI
// .xml 파일 - 자동으로 EXI로 인코드
var autoArgs = new List<string> { "--encode", args[0] };
// Add remaining args (like -out)
// 나머지 인자 추가 (-out 등)
for (int i = 1; i < args.Length; i++)
autoArgs.Add(args[i]);
HandleEncodeCommand(autoArgs.ToArray());
}
else
{
// Unknown extension - require explicit option
// 알 수 없는 확장자 - 명시적 옵션 필요
Console.WriteLine($"Error: Unknown file extension '{extension}'. Please specify operation:");
Console.WriteLine($" {Path.GetFileName(args[0])} --decode # To decode as EXI to XML");
Console.WriteLine($" {Path.GetFileName(args[0])} --encode # To encode as XML to EXI");
@@ -210,22 +193,22 @@ namespace V2GProtocol
byte[] exiBytes;
string outputFile = GetOutputFilename(args);
// Check if we have sufficient arguments for file/string input
// 파일/문자열 입력을 위한 충분한 인자가 있는지 확인
if (args.Length >= 2)
{
// We have command line arguments, use them
// 명령줄 인자가 있으므로 사용
input = args[1];
}
else if (Console.IsInputRedirected)
{
// No sufficient arguments, check if input is coming from stdin (pipe)
// 충분한 인자가 없으므로 stdin(파이프)에서 입력이 오는지 확인
input = Console.In.ReadToEnd().Trim();
if (string.IsNullOrEmpty(input))
{
Console.WriteLine("Error: No input data received from stdin");
return;
}
outputFile = null; // Force console output for stdin
outputFile = null; // stdin의 경우 콘솔 출력 강제
}
else
{
@@ -234,18 +217,18 @@ namespace V2GProtocol
return;
}
// Check if input is a file
// 입력이 파일인지 확인
if (File.Exists(input))
{
// Handle different file extensions
// 다양한 파일 확장자 처리
string extension = Path.GetExtension(input).ToLower();
if (extension == ".dump")
{
// Hex dump file format with arrows (→)
// 화살표(→)가 있는 헥스 덤프 파일 형식
byte[] rawData = V2GDecoder.ParseHexFile(input);
// Find V2G message in the hex dump
// 헥스 덤프에서 V2G 메시지 찾기
var v2gMessage = ExtractV2GMessageFromHexDump(rawData);
if (v2gMessage != null)
{
@@ -253,22 +236,22 @@ namespace V2GProtocol
}
else
{
// Try to decode the raw data directly (might be pure EXI without V2G header)
// 원시 데이터를 직접 디코드 시도 (V2G 헤더 없는 순수 EXI일 수 있음)
exiBytes = rawData;
}
}
else if (extension == ".hex")
{
// Binary hex file
// 바이너리 hex 파일
exiBytes = File.ReadAllBytes(input);
}
else if (extension == ".txt")
{
// Legacy support for .txt files - check content format
// .txt 파일에 대한 레거시 지원 - 컨텐츠 형식 확인
string fileContent = File.ReadAllText(input).Trim();
if (fileContent.Contains("→"))
{
// Hex dump format
// 헥스 덤프 형식
byte[] rawData = V2GDecoder.ParseHexFile(input);
var v2gMessage = ExtractV2GMessageFromHexDump(rawData);
if (v2gMessage != null)
@@ -282,22 +265,22 @@ namespace V2GProtocol
}
else
{
// Plain hex
// 순수 헥스
fileContent = fileContent.Replace(" ", "").Replace("-", "").Replace("0x", "").Replace("\n", "").Replace("\r", "");
exiBytes = FromHexString(fileContent);
exiBytes = Helper.FromHexString(fileContent);
}
}
else
{
// Unknown extension, try as plain hex
// 알 수 없는 확장자, 순수 헥스로 시도
string fileContent = File.ReadAllText(input).Trim();
fileContent = fileContent.Replace(" ", "").Replace("-", "").Replace("0x", "").Replace("\n", "").Replace("\r", "");
exiBytes = FromHexString(fileContent);
exiBytes = Helper.FromHexString(fileContent);
}
}
else
{
// Direct hex string input
// 직접 헥스 문자열 입력
string exiHexString = input.Replace(" ", "").Replace("-", "").Replace("0x", "");
if (exiHexString.Length % 2 != 0)
@@ -306,23 +289,23 @@ namespace V2GProtocol
return;
}
exiBytes = FromHexString(exiHexString);
exiBytes = Helper.FromHexString(exiHexString);
}
try
{
// Decode EXI to XML - output only the XML
// EXI를 XML로 디코드 - XML만 출력
var decodedXml = V2GDecoder.DecodeEXIToXML(exiBytes);
if (outputFile != null)
{
// Save to file
// 파일로 저장
File.WriteAllText(outputFile, decodedXml);
Console.WriteLine($"Decoded XML saved to: {outputFile}");
}
else
{
// Output to console
// 콘솔로 출력
Console.WriteLine(decodedXml);
}
}
@@ -334,15 +317,15 @@ namespace V2GProtocol
static byte[] ExtractV2GMessageFromHexDump(byte[] data)
{
// Find V2G Transfer Protocol signature (0x01FE)
// V2G Transfer Protocol 시그니처 찾기 (0x01FE)
for (int i = 0; i < data.Length - 8; i++)
{
if (data[i] == 0x01 && data[i + 1] == 0xFE)
{
// Get payload length
// 페이로드 길이 가져오기
uint payloadLength = (uint)((data[i + 4] << 24) | (data[i + 5] << 16) | (data[i + 6] << 8) | data[i + 7]);
// Extract EXI payload
// EXI 페이로드 추출
if (i + 8 + payloadLength <= data.Length)
{
byte[] exiPayload = new byte[payloadLength];
@@ -360,13 +343,13 @@ namespace V2GProtocol
string xmlContent;
string outputFile = GetOutputFilename(args);
// Check if we have sufficient arguments for file/string input
// 파일/문자열 입력을 위한 충분한 인자가 있는지 확인
if (args.Length >= 2)
{
// We have command line arguments, use them
// 명령줄 인자가 있으므로 사용
xmlInput = args[1];
// Check if input is a file
// 입력이 파일인지 확인
if (File.Exists(xmlInput))
{
xmlContent = File.ReadAllText(xmlInput);
@@ -378,14 +361,14 @@ namespace V2GProtocol
}
else if (Console.IsInputRedirected)
{
// No sufficient arguments, check if input is coming from stdin (pipe)
// 충분한 인자가 없으므로 stdin(파이프)에서 입력이 오는지 확인
xmlContent = Console.In.ReadToEnd().Trim();
if (string.IsNullOrEmpty(xmlContent))
{
Console.WriteLine("Error: No input data received from stdin");
return;
}
outputFile = null; // Force console output for stdin
outputFile = null; // stdin의 경우 콘솔 출력 강제
}
else
{
@@ -396,7 +379,7 @@ namespace V2GProtocol
try
{
// Encode XML to EXI
// XML을 EXI로 인코드
var exiBytes = V2GDecoder.EncodeXMLToEXI(xmlContent);
if (outputFile != null)
@@ -406,13 +389,13 @@ namespace V2GProtocol
Console.WriteLine($"Encoded binary saved to: {outputFile} ({exiBytes.Length} bytes)");
// Also show hex string on console for reference
var exiHexString = ToHexString(exiBytes);
var exiHexString = Helper.ToHexString(exiBytes);
Console.WriteLine($"Hex: {exiHexString}");
}
else
{
// Output hex string to console
var exiHexString = ToHexString(exiBytes);
var exiHexString = Helper.ToHexString(exiBytes);
Console.WriteLine(exiHexString);
}
}

14
V2GDecoder.cs
View File

@@ -8,18 +8,6 @@ namespace V2GProtocol
{
public class V2GDecoder
{
static byte[] FromHexString(string hexString)
{
if (hexString.Length % 2 != 0)
throw new ArgumentException("Invalid hex string length");
byte[] bytes = new byte[hexString.Length / 2];
for (int i = 0; i < bytes.Length; i++)
{
bytes[i] = Convert.ToByte(hexString.Substring(i * 2, 2), 16);
}
return bytes;
}
private const byte V2G_TP_VERSION = 0x01;
private const byte V2G_TP_INVERSE_VERSION = 0xFE;
@@ -1069,7 +1057,7 @@ namespace V2GProtocol
var sessionId = ExtractValueFromXML(xmlContent, "SessionID");
if (!string.IsNullOrEmpty(sessionId) && sessionId.Length == 16) // 8 bytes as hex
{
var sessionBytes = FromHexString(sessionId);
var sessionBytes = Helper.FromHexString(sessionId);
foreach (byte b in sessionBytes)
{
if (b >= 0x30 && b <= 0x5A) // ASCII range