SharpOdinClient

Sharpodinclient

SharpodInclient هي مكتبة .NET تسمح بتطبيقات .NET بالتواصل مع أجهزة Samsung Android في وضع التنزيل.

عميل مناسب لـ Flash (Image ، Tar.md5 ، LZ4) ، الحصول على المعلومات وتنفيذ ميزات أخرى.

ويوفر تنفيذ .NET لبروتوكول ODIN.

متطلبات:

• .NET Framework 4.5.1
• سائق Samsung USB الرسمي

كيف يعمل؟

اتصالات USB في SharpodinClient هي SerialPort.

1. تثبيت سائق Samsung USB الرسمي
2. قم بتوصيل جهازك في وضع التنزيل

مساحات الأسماء

أضف أولاً مساحات أسماء SharpodinClient في مشروعك

 using SharpOdinClient.structs;
using SharpOdinClient.util;

اشترك في الأحداث

        private Odin Odin = new Odin();
        public MainWindow()
        {
            InitializeComponent();

            Odin.Log += Odin_Log;
            Odin.ProgressChanged += Odin_ProgressChanged;
        }

        private void Odin_ProgressChanged(string filename, long max, long value, long WritenSize)
        {
                
        }

        private void Odin_Log(string Text, SharpOdinClient.util.utils.MsgType Color)
        {
        }

1. حدث ProgressChanged

   اسم الملف: اسم ملف الوميض على الجهاز

   ماكس: حجم الملف

   القيمة: حجم الملف مكشوف

2. الحدث السجل

   النص: نص سجل

   اللون: لون السجل

البحث تلقائيًا أجهزة Samsung في وضع التنزيل

        {
            //Find Auto odin device
            var device = await Odin.FindDownloadModePort();
            //device name
            Console.WriteLine(device.Name);

            // COM Port Of device 
            Console.WriteLine(device.COM);

            // VID and PID Of Device
            Console.WriteLine(device.VID);
            Console.WriteLine(device.PID);
        }

اقرأ المعلومات من الجهاز

        {
            if(await Odin.FindAndSetDownloadMode())
            {
                //get info from device
                var info = await Odin.DVIF();
                await Odin.PrintInfo();
            }
        }

في متغير info نحصل على قاموس string ، string مفهوم بعض "المفاتيح"

• capa = رقم CAPA
• product = معرف المنتج
• model = رقم الطراز
• fwver = إصدار البرامج الثابتة
• vendor = البائع
• sales = رمز المبيعات
• ver = رقم البناء
• did = رقم
• un = معرف فريد
• tmu_temp = رقم TMU
• prov = توفير

اقرأ الحفرة من الجهاز

        {
            if(await Odin.FindAndSetDownloadMode())
            {
                await Odin.PrintInfo();
                if (await Odin.IsOdin())
                {
                    if(await Odin.LOKE_Initialize(0))
                    {
                        var Pit = await Odin.Read_Pit();
                        if (Pit.Result)
                        {
                            var buffer = Pit.data;
                            var entry = Pit.Pit;
                        }
                    }
                }
            }
        }

للقيام بأي إجراء في وضع التنزيل ، تحتاج أولاً إلى التحقق IsOdin وتشغيل الوسيطة LOKE_Initialize ، إذا كنت لا ترغب في كتابة أي شيء على جهاز مجموعة LOKE_Initialize totalfilesize المعلمة إلى الصفر (0)

buffer = is byte pit of pit from device ، يمكنك كتابة هذا المخزن المؤقت في الملف لحفظ entry الحفرة = قائمة معلومات القسم الخاص بجهازك

اكتب حفرة على الجهاز

  /// <summary>
        /// write pit file on your device
        /// </summary>
        /// <param name="pit">in this parameter, you can set tar.md5 contains have pit file(Like csc package of firmware)
        /// or pit file with .pit format
        /// </param>
        /// <returns>true if success</returns>
        public async Task<bool> Write_Pit(string pit)
        {
            if (await Odin.FindAndSetDownloadMode())
            {
                await Odin.PrintInfo();
                if (await Odin.IsOdin())
                {
                    if (await Odin.LOKE_Initialize(0))
                    {
                        var Pit = await Odin.Write_Pit(pit);
                        return Pit.status;
                    }
                }
            }
            return false;
        }

• معلمة pit = إذا كنت ترغب في كتابة PIT من ملف TAR أو TAR.MD5 (مثل CSC) على الجهاز ، يمكنك تعيين مسار ملف TAR TYPE ، يمكنك أيضًا تعيين ملف PIT الخاص بك بملف تنسيق .PIT

قائمة فلاش حزمة tar.md5 على الجهاز

        /// Add List Of Your tar package (bl,ap,cp,csc , or more)
        /// </summary>
        /// <param name="ListOfTarFile">add tar type files path in this list</param>
        /// <returns></returns>
        public async Task<bool> FlashFirmware(List<string> ListOfTarFile)
        {
            var FlashFile = new List<FileFlash>();
            foreach(var i in ListOfTarFile)
            {
                var item = Odin.tar.TarInformation(i);
                if(item.Count > 0)
                {
                    foreach (var Tiem in item)
                    {
                        if (!Exist(Tiem , FlashFile))
                        {
                            var Extension = System.IO.Path.GetExtension(Tiem.Filename);
                            var file = new FileFlash
                            {
                                Enable = true,
                                FileName = Tiem.Filename,
                                FilePath = i
                            };

                            if (Extension == ".pit")
                            {
                                //File Contains have pit
                            }
                            else if (Extension == ".lz4")
                            {
                                file.RawSize = Odin.CalculateLz4SizeFromTar(i, Tiem.Filename);
                            }
                            else
                            {
                                file.RawSize = Tiem.Filesize;
                            }
                            FlashFile.Add(file);
                        }
                    }
                }
               
            }

            if(FlashFile.Count > 0)
            {
                var Size = 0L;
                foreach (var item in FlashFile)
                {
                    Size += item.RawSize;
                }
                if (await Odin.FindAndSetDownloadMode())
                {
                    await Odin.PrintInfo();
                    if (await Odin.IsOdin())
                    {
                        if (await Odin.LOKE_Initialize(Size))
                        {
                            var findPit = FlashFile.Find(x => x.FileName.ToLower().EndsWith(".pit"));
                            if(findPit != null)
                            {
                                var res = MessageBox.Show("Pit Finded on your tar package , you want to repartition?", "", MessageBoxButton.YesNo);
                                if (res == MessageBoxResult.Yes)
                                {
                                    var Pit = await Odin.Write_Pit(findPit.FilePath);

                                }
                            }
                          
                            var ReadPit = await Odin.Read_Pit();
                            if (ReadPit.Result)
                            {
                                var EfsClearInt = 0;
                                var BootUpdateInt = 1;
                                if (await Odin.FlashFirmware(FlashFile, ReadPit.Pit, EfsClearInt, BootUpdateInt, true))
                                {
                                    if (await Odin.PDAToNormal())
                                    {
                                        return true;
                                    }
                                }
                            }
                        }
                    }
                }
            }


            return false;
        }

من أجل الولادة ، يحتوي tar.md5 على ملفات (LZ4 ، Image ، Bin والمزيد ...) نحتاج إلى إنشاء قائمة FileFlash من معلومات حزمة Tar.

Enable الخاصية في FileFlash هو bool إذا قمت بتعيين هذا propery على False ، لا تومض SharpodinClient على الهاتف.

في وظيفة FlashFirmware ، يمكن لـ SharpodinClient كتابة LZ4 من حزمة القطران

فلاش ملف واحد

يمكنك وميض الملف المفرد مثل boot.img أو المزيد من الملفات على الأقسام

        /// <summary>
        /// Flash Single File lz4 , image
        /// </summary>
        /// <param name="FilePath">path of your file</param>
        /// <param name="PartitionFileName">like boot.img , sboot.bin or more ...</param>
        /// <returns></returns>
        public async Task<bool> FlashSingleFile(string FilePath , string PartitionFileName)
        {
            var FlashFile = new FileFlash
            {
                Enable = true,
                FileName = PartitionFileName,
                FilePath = FilePath,
                RawSize = new FileInfo(FilePath).Length
            };

            if (await Odin.FindAndSetDownloadMode())
            {
                await Odin.PrintInfo();
                if (await Odin.IsOdin())
                {
                    if (await Odin.LOKE_Initialize(FlashFile.RawSize))
                    {
                        var ReadPit = await Odin.Read_Pit();
                        if (ReadPit.Result)
                        {
                            var EfsClearInt = 0;
                            var BootUpdateInt = 0;
                            if (await Odin.FlashSingleFile(FlashFile, ReadPit.Pit, EfsClearInt, BootUpdateInt, true))
                            {
                                if (await Odin.PDAToNormal())
                                {
                                    return true;
                                }
                            }
                        }
                    }
                }
            }


            return false;
        }