http___microbit.org_hr_hardware_usb__1.xml
1.1 2.1 3.1 4.1 5.1 6.1 7.1 7.2 7.3 8.1 9.1 10.1 10.2 10.3 11.1 11.2 12.1 13.1 13.2 13.3 14.1 14.2 15.1 16.1 17.1 18.1 18.2 19.1 20.1 21.1 22.1 22.2 23.1 24.1 25.1 26.1 27.1 28.1 29.1
QUESTION How can I protect a .hex file (e.g. a teaching resource) so the source code is not readable? I want to lock a .hex file so that students can't see the contents. I want to give a .hex file to students that demonstrates a target to achieve, but in a way they cannot read the source code. How can I prevent 'dragging and dropping' a .hex file into the Javascript Blocks Editor from viewing the source code? BACKGROUND The Javascript Blocks Editor attempts to embed a compressed version of the original program source code into the .hex file, if there is space for it. The method that is used to compress and embed is described in the links at the end of this article. This is so that if you drag and drop a .hex file back into the makecode.microbit.org editor it will reconstruct your source program for you to allow you to view and change it. However, sometimes it is useful to be able to 'lock' a .hex file, perhaps you have written a program that you want students to download from the web or from your intranet and load it onto the micro:bit to work out what it does, but you don't want them to be able to 'cheat' and drag and drop the .hex file into the makecode.microbit.org editor to view the original source program. STEPS TO LOCK A FILE Open the .hex file in a text editor such as Notepad on windows, or TextEdit on a Apple Mac. This is an intel-hex format file, the format of which is described in the links below. Basically each line has a short header, and the last two characters of the line are a computed checksum formed by adding up all the data on that line. Search for the string 41140E2FB82FA2BB using the search feature of your text editor. If you can't find this magic string, try searching for a shorter part of it such as 2FB82FA2BB, as it *might* span multiple lines. Find the '41' part and change it to '40' - this reduces the total sum of the line by one, so... at the end of that line, look at the last two characters. This is a hex number. Add one to it to make sure that the checksum is now correct. Save the file, then try and drag and drop it into makecode.microbit.org - it should now be impossible for Javascript Blocks Editor to read it. It will pop up an orange message saying 'Sorry we could not recognize this file'. Drag and drop the file onto the MICROBIT drive, and make sure your code works. EXAMPLE The attached hex file microbit-secret.hex has been locked, try dragging and dropping it into pxt.microbit.org and you will see that it will not load it. Here is how we locked that .hex file. First we searched for the magic string - in this case the :10FCC000 before it is part of the memory address information that appears at the start of every intel-hex line. Then, we changed the 41 to a 40 (thus reducing the sum of the line by one) and added one to the 30 checksum at the end, making it 31. Finally, we saved this file, then drag and dropped into into Javascript Blocks Editor to prove it was locked. Note, if you update the checksum incorrectly, the file will not load properly onto the micro:bit, so make sure you test it on your micro:bit too before distributing it. When you modify the last two characters of the line to add one to the checksum, this is a hexadecimal number, and it must be updated cyclically. So, here are some examples of how to 'add one' to a 2 digit (8 bit) hex number 30 becomes 31 39 becomes 3A 3F becomes 40 FF becomes 00 FURTHER INFORMATION [1] Detailed information about the Javascript Blocks Editor metadata record: https://support.microbit.org/solution/articles/19000044768--hex-file-format [2] Intel Hex format: https://en.wikipedia.org/wiki/Intel_HEX
1.1 2.1 3.1 4.1 5.1 6.1 7.1 7.2 8.1 9.1 10.1 11.1 12.1 13.1 14.1 14.2 14.3 15.1 16.1 17.1 18.1 19.1 20.1 21.1 22.1 23.1 23.2 24.1 24.2 25.1 26.1 27.1 27.2 27.3 28.1 28.2 29.1 30.1 31.1 31.2 31.3 33.1 33.2 34.1 35.1 36.1 36.2 36.3 36.4 37.1 38.1 38.2 38.3 38.4 39.1 40.1 40.2 40.3 40.4 41.1 42.1 43.1 44.1 45.1 45.2 45.3 46.1 47.1 48.1 49.1 50.1 50.2 51.1 51.2 52.1 53.1 54.1 55.1 55.2 55.3
Pokreni programe na svom BBC micro:bitu Svoje programe (kôd, skriptu) pišeš i testiraš u našim editorima (uređivačima), ali uglavnom ćeš ih izvršavati u svom pregledniku tako da klikneš tipku Pokreni (vidi pokretanje kôda u pregledniku za informacije o tome). Kad završiš svoje remek-djelo, možeš svoj kôd kompajlirati i pokrenuti ga na svom BBC micro:bitu. Zahtjevi Potrebno ti je sljedeće za prebaciti i pokrenuti skriptu na svoj BBC micro:bit: - Muški-mikro USB kabel za povezivanje tvog računala s micro:bitom. To je isti onaj kabel koji se najčešće koristi za povezivanje pametnog telefona s računalom. - računalo sa sustavom Windows 7 ili kasnijim, ili Mac koji ima OS X 10.6 ili kasniji - pristup internetu Korak 1: Spoji BBC micro:bit na svoje računalo Prvo, poveži BBC micro:bit: - Poveži mali kraj USB kabela na mikro USB priključak na svom BBC micro:bitu. - Spoji drugi kraj USB kabela u USB priključak na računalu. Tvoje računalo bi trebalo prepoznati micro:bit kao novi disk. Na računalima sa sustavom Windows, pojavit će se MICROBIT kao novi disk pod Uređaji i diskovi. Na Macu se pojavljuje kao novi disk pod Uređaji. Windows Mac 2. korak: Kompajliraj svoju skriptu (program) Zatim, kompajliraj skriptu: - U tvom pregledniku, otvori skriptu (nađi original u Moje skripte i pritisni Uređivanje). - Klikni kompajliratiili preuzmi datoteku. Tvoja skripta se pretvara u hex datoteku koje možeš prenijeti i pokrenuti na svoj BBC micro:bit. - Kada se to zatraži, spremi kompajliranu datoteku na svoje računalo (ili bilo gdje osim na BBC micro:bit). Ovisno o tome koji preglednik koristiš, preuzimanje će se odvijati u skladu s načinom rada tog preglednika. Windows Chrome Tvoja .hex datoteka s prikazuje kao datoteka za preuzimanje (download) na dnu preglednika. Otvori Windows Explorer. Tvoj micro:bit se pojavljuje kao disk MICROBIT. Desni klik na preuzetu datoteku (download) i odaberi Prikaži u mapi / show in folder. Povuci i ispusti hex datoteku iz mape za preuzimanja na MICROBIT disk. Alternativno, možeš povući-i-ispustiti preuzetu hex datoteku od dna preglednika u prozor Explorera i na MICROBIT disk. Firefox Prikazat će se okvir dijaloga, koji će pitati da li želiš otvoriti ili spremiti hex datoteku. Odaberi Spremi, a zatim U redu / OK i datoteka će se pojaviti u preuzimanjima u gornjem desnom kutu tvog preglednika. Odaberi plavu strelicu, odaberi odgovarajuću datoteku i povuci i ispusti na Windows Explorer i na disk MICROBIT. Klikni na 'kompajliraj'. Vidjet ćeš poruku "Želite li spremiti ovu .hex datoteku." Odaberi Spremi. Mac Safari Kada odabereš kompajliraj / compile u Safariju na Mac računalu, datoteka će se preuzeti u mapu preuzimanja. Idi u mapu preuzimanja i otvori datoteku. U Safariju će se datoteka pojaviti kao unknown.txt umjesto kao .hex datoteka s imenom. Povuci i ispusti ju na disk MICROBIT. Firefox Prikazat će se okvir dijaloga, koji će pitati da li želiš otvoriti ili spremiti hex datoteku. Odaberi Spremi, a zatim U redu / OK i datoteka će se pojaviti u preuzimanjima u gornjem desnom kutu tvog preglednika. Klikni na Prikaži u Finder i datoteka će se pojaviti u mapi preuzimanja. Odaberi datoteku i povuci i ispusti ju na disk MICROBIT. Chrome Kada odabereš kompajliraj u pregledniku Chrome, datoteka će se preuzeti na dnu preglednika u .hex obliku. Klikni na malu strelicu i odaberi Pokaži u Finderu. To će prikazati datoteku u mapi preuzimanja. Povuci i ispusti datoteku na disk MICROBIT. 3. korak: Prenesi datoteku na svoji BBC micro:bit - Datoteka će se prenijeti na BBC micro:bit. - Ako koristiš Windows, možeš upotrijebiti Pošaljite na / Send to kao što je opisano ispod. - LED-ica na stražnjoj strani BBC micro:bita treperi tijekom prijenosa (koji bi trebao trajati samo nekoliko sekundi). - Nakon prebacivanja, kôd će se automatski pokrenuti na BBC micro:bitu. Da bi ponovno pokrenuo svoj program, pritisni tipku RESET na poleđini svog BBC micro:bita. Tipka (gumbić) za reset pokreće najnoviju datoteku na BBC micro:bitu. Pošalji na / Send toi: Ako koristiš Windows, upotrijebi Pošalji na / Send to u File Exploreru: - U File Exploreru, desni klik na hex datoteku (stvorenu u koraku 2 gore), izaberi Pošalji na / Send to, a zatim MICROBIT. Kopiranjem skripte na disk 'MICROBIT', ona je isprogramirana u flash memoriju na micro:bitu, što znači da čak i nakon što odspojiš micro:bit, skripta će se izvršavati ako je micro:bit napajan baterijama. Rješavanje problema Ne možeš povući i ispustiti više hex datoteka odjednom na svoj micro:bit. Ukoliko pokušaš povući i ispustiti drugu hex datoteku na svoj micro:bit prije nego se prva datoteka spremila, tada ta druga datoteka može biti nesipravna na razne načine. Kada je prvi program napisan na micro:bit, disk će se odvojiti. Ako tada povučeš i ispustiš drugu datoteku, ona možda neće naći disk i to drugo zapisivanje se neće izvršiti. Pogreške mogu izgledati ovako: Windows Mac Ili može izgledati kao da su dvije hex datoteke na tvom BBC micro:bitu, pa micro:bit neće moći izvršiti višestruke datoteke. Da to ispraviš, odspoji svoj micro:bit i ponovo ga spoji. Provjeri da se tvoj micro:bit pojavljuje kao MICROBIT a ne kao MAINTENANCE.