• Glue Tools Serial

Serial.tools.listportsThis module can be executed to get a list of ports ( python -m serial.tools.listports). It also contains the following functions. Comports ( includelinks=False ) Parameters:includelinks – include symlinks under /dev when they pointto a serial portReturns:a list containing objects.The function returns a list of objects.Items are returned in no particular order. It may make sense to sort theitems.

Also note that the reported strings are different across platformsand operating systems, even for the same device. NoteSupport is limited to a number of operating systems. On somesystems description and hardware ID will not be available( None).Under Linux, OSX and Windows, extended information will be available forUSB devices (e.g.

The string contains VID:PID,SER (serial number), LOCATION (hierarchy), which makes them searchablevia. The USB info is also available as attributes of.If includelinks is true, all devices under /dev are inspected andtested if they are a link to a known serial port device. These entrieswill include LINK in their hwid string. This implies that the samedevice listed twice, once under its original name and once under linkedname. Platform:Posix (/dev files)Platform:Linux (/dev files, sysfs)Platform:OSX (iokit)Platform:Windows (setupapi, registry)serial.tools.listports. Grep ( regexp, includelinks=False ) Parameters:.

regexp – regular expression (see stdlib ). includelinks – include symlinks under /dev when they pointto a serial portReturns:an iterable that yields objects, see also.Search for ports using a regular expression. Port name,description and hwid are searched (case insensitive). The functionreturns an iterable that contains the same data thatgenerates, but includes only those entries that match the regexp.

Class serial.tools.listports. ListPortInfoThis object holds information about a serial port. It supports indexedaccess for backwards compatibility, as in port, desc, hwid = info. DeviceFull device name/path, e.g.

This is also theinformation returned as first element when accessed by index. NameShort device name, e.g. DescriptionHuman readable description or n/a. This is also the informationreturned as second element when accessed by index. HwidTechnical description or n/a. This is also the informationreturned as third element when accessed by index.USB specific data, these are all None if it is not an USB device (or theplatform does not support extended info). VidUSB Vendor ID (integer, 065535).

PidUSB product ID (integer, 065535). SerialnumberUSB serial number as a string. LocationUSB device location string (“-”) manufacturerUSB manufacturer string, as reported by device. ProductUSB product string, as reported by device. InterfaceInterface specific description, e.g. Used in compound USB devices.Comparison operators are implemented such that the objectscan be sorted by device.

Strings are split into groups of numbers andtext so that the order is “natural” (i.e. Serial.tools.minitermThis is a console application that provides a small terminal application.Miniterm itself does not implement any terminal features such as VT102compatibility. However it may inherit these features from the terminal it is run.For example on GNU/Linux running from an xterm it will support the escapesequences of the xterm. On Windows the typical console window is dumb and doesnot support any escapes. When ANSI.sys is loaded it supports some escapes.The default is to filter terminal control characters, see -filter fordifferent options.Miniterm.

Glue Tools Serial

This is how you jailbreak a Paperwhite or Voyage using windows software. Good luck, fellow kindlers!These instructions were created on a Paperwhite 2.

Physical differences aside, they will work on any kindle that:. Has a firmware version in the 5.x.y series.

Is a touchscreen Kindle modelA link to a Linux version of this can be found.Like most things in life, this guide is probably full of mistakes. If you find any, please let me know so I can fix them.Part 1: Get what you need!1.

And its serial #.Write that down. (apparently you should hide your serial #. So i've hidden part of mine. Come @ me, haxors!)2. USB - Serial converter board.This is what most people use: because it's cheap & does the job.You want to specifically order option #3. This is necessary because your kindle uses 1.8v signals and if you use 3.3v or 5.0v, you can blow up your chips.3. Two USB cables to connect to your Windows computerWe are lazy, so it will be most convenient to be able to hook up the kindle + the serial converter board at the same time.If you are not using windows, then you are probably some ultra-smart linux pro who doesn't need a dummies guide anyways.4.

Usb converter driversDownload and install the correct drivers. These are what will allow your computer to talk to the serial converter board.5. Soldering iron, conductive glue, wires, clips, pins, magnifier, etc.Whatever you need to connect wires to tiny metal spots on the computer board. It's a delicate operation.6. Small screwdrivers, thin knives, and some tupperwareWhatever you need to break apart your kindle & get at the tasty goodness inside.The containers are essential to hold your parts so they don't get lost!7. Python software. Install on your machine.

I used version 3.5.0, but other versions should work fine.Don't worry, we're not going to write complex code!8. PuTTy software.This is the program that lets your computer talk to the kindle over the serial port. You don't need to install it; it just runs.9. Mobileread SoftwaresDownload and unzip all these awesome packages provided by Mobileread smartguys. Keep them handy, we'll come to them later. This is what unlocks the power!

(The jailbreak software was recently updated to behave better for our serial jailbreaks, so we are going to download the latest version from NiJuLe's daily snapshot thread instead of getting the older version from the Jailbreak thread.) (thanks NiJuLe!)Hint: Use '7-Zip' or 'WinRar' to unpack the jailbreak software. This runs the goodies you want to install. (thanks twobob!). You need this to install those goodies. (thanks NiLuJe!).

we'll install this to confirm the jailbreak worked. (thanks NiLuJe!).

Part 2: The Physical SetupVoyage users: stupidhaiku has supplemental pictures & instructions to help you! Crack open the KindlePeel off the front cover. It's held down with glue or tape.I prefer to heat it up with a hairdryer to soften the glue, and then I stick an exacto knife into the seam near the corner to start prying it up.In case you want more help, here is a2. Remove the screwsThere are 11 screws. The one in the middle is hidden underneath adhesive tape- don't miss it!Tiny screws are like children! They love to play hide & seek! So make sure you put them immediately into your previously-obtained plastic container so have no chance to escape your merciless screwdriver.3.

Remove the battery. Pry the silver frame (which holds the screen) out of the black back cover.b. Flip it over and put it onto a tupperware lid so you don't get crumbs on the adhesive on the front.c.

Remove the 3 screws holding the battery and pull out the battery. Put them all in your container'o'screw-storage for safekeeping.Play safe! It's dangerous to wield a soldering iron near lithium & live current4. Unhook cables1st cable:You don't want your delicate fragile cables getting in the way of mean mr. Soldering iron. Peel back the tape (Yellow).

Lift the tiny lever that holds the cable in place (Red). Pull out the cable. Wrap the tape & cable behind the screen2nd cable. Lift the cable out from its socket (Pink). Wrap the cable behind the screen5. Connect the USB converter board!Use your soldering tools to do this work.

You need to make these 4 connections. Code: Converter Kindle Board On DiagramV TP1706 Blue ArrowGND (Any Ground) Purple ArrowsRX Left Serial Red ArrowTX Center Serial Green Arrow Hint: You can connect to any of the possible ground points. The metal plates are very convenientHere is a close-up of my own soldering adventure:6. Reconnect screen and batteryYour kindle needs powah.!

Reconnect:. Screen cables.

Battery. Plug USB Serial converter into your computer. Plug Kindle into your computerI have taped my USB board to the frame because my soldering skills are weak and I didn't want to risk pulling things loose as I moved it around.BONUS: These other kindlers show off some great ideas on how to connect your serial port:. Part 3: Windows Computer Setup1. Get your Kindle's passwordPython can magically turn your serial number into your kindle's password. We will need the password to do tricky things with it.Open a command promptRun 'Python' and execute these commands:import hashlibprint('fiona%s'%hashlib.md5(' n'.encode('utf-8')).hexdigest13:16)What pops out is your root password!

'fiona xxx'Hint: If you cannot run python it means you did not install it properly2. Set up your COM portNow we need configure your computer to talk to the USB converter board.Plug board into your computer.Open 'Device Manager' and find the 'USB Serial Port (COM3)' item which is now availableHint: If this device isn't showing in windows, it means you didn't install the drivers correctly!Right-click the item and edit its propertiesClick 'Port Settings' and set everything like below:3. Set up PuTTyPutty is the program that will talk to your kindle.

Open the program, create, and save a new connection with these settings:- Connection Type = 'Serial'- Serial line = 'COM3' or whatever COM # this shows up as in device manager- Speed = '115200'Navigate to 'Connection' - 'Serial' and set up the options to match what you set up in device managerSave the session again (sometimes putty forgets stuff.) and then open the session:A new blank, black window will appear. This is the window which lets us talk to the kindle. Part 4: Hackery stuffThis is the most confusing part of the whole jailbreak process. There's lots of pictures so even someone as slow as me can get through things.1.

Code: mkdir /tmp/mainmount /dev/mmcblk0p1 /tmp/mainvi /tmp/main/etc/passwdThe Vi program will load and put the password file on the screenUse the arrow keys to move the cursor over the 'x' (it might be a '!' Instead) which is right after 'root:'.Press ' x' to delete the xHint: The 'delete' key doesn't actually delete characters in this program.

Just roll with it.The file now looks like thisRemoving the 'x' is telling the system that the main root account doesn't need a password.Type ':w' to save the file & exit the editorThe text editor will close, but the file will still appear on the screen. Don't be afraid of that, it's ok.Type ' reboot' to restart the kindle3. Run the jailbreakNow we get to the meat of the matter! Let's make it rain!Wait for your kindle to finish booting. It will appear as a storage device on your computer.Copy all of the files from the jailbreak.ZIP to the base directory on the kindle'Eject' the kindle from your computer and unplug it.Warning: Leave the USB serial converter plugged in!In your putty window, press 'Enter' This will display the login promptType root to log inType these 2 commands. Code: cd /mnt/ussh jb.shThe jailbreak will do its businessHint: If you are watching the screen, you will see the word '.

JAILBREAK.' appear at the bottomWhen the PuTTy screen has stopped scrolling, reboot your kindle again:Wait for the kindle to finish rebootingPlug your kindle into the computer and look at the Kindle storage in windowsYou will see new directories have been made by the jailbreaking4. Protect your jailbreakAmazon is sneaky, even sneakier than those tiny little screws which will try to escape your tupperware!

If we are not careful, they will secretly upload new software to your kindle and ruin everything!Hint: Keep your kindle in 'airplane mode' all the time. This keeps your precious device safe from Amazon poking at it.BUT: If you must connect to the internet (e.g., to register your device) We will also set up a little protection to make sure no updates are snuck in under your noseOn your kindle create a new directory called: 'update.bin.tmp.partial'This directory will confuse silly Amazon and stop them from uploading any software. Part 5: Install some goodiesWe will put some basics onto your kindle now that it's been uncaged1.

Install KUALKUAL provides a GUI to manage other programs on your kindleCopy the 'azw2' file from the KUAL zip to the 'Documents' directory of your kindleEject the kindle from your computer'Restart' your kindle from the screen menuWhen your kindle is restarted, you will see the 'Kindle Launcher' is now available2. Install KUAL HelperThis helps KUAL be better than ever. (I think it lets your goodies appear in the KUAL menus)Connect your kindle to your computerCopy the 'Helper' directory from the KUAL Helper zip into the 'Extensions' directory on your kindleEject the kindle from your computer'Restart' your kindle from the screen menuHint: I am not certain that ejecting & restarting the kindle is necessary, but I do it anyways3. Install KUAL MRInstallerThis is an add-on for KUAL that allows add-on packages to be installed very easily. I think it needs KUAL helper which is why we are doing it 3rdCopy the 2 directories from the MRInstaller zip to the root of your kindle.This means a new directory called 'MRInstaller' will be created inside extensions, and another directory called 'mrpackages' will be created in the root'4.

Install Screensaver hackThis will let you change which screensavers appear when your kindle is sleeping.