Users » okano » Code » ika_shouyu_poppoyaki

Tedd OKANO / Mbed 2 deprecated ika_shouyu_poppoyaki

this transfers data (which is stored in "bin" file in mbed storage) into LPC1114, LPC1115, LPC81x, LPC82x, LPC1768/LPC1769 and LPC11U68/LPC11E68 internal flash memory through ISP.

Dependencies: mbed MODSERIAL DirectoryList

Information

日本語版がこのページ下半分にあります！

Japanese version is available lower half of this page.

Caution!

このプログラムでイカを焼くことはできません (^ ^;

"Ika-shouyu-poppoyaki" is a name of Japanese local food.
If I try to do a direct translation, it will be something like "Choo-choo grilled calamari with soy-sauce".
However, you may noticed already, it cannot be grilled by this program ;-)

ISP programming application on mbed

ISP program writes data into flash memory of target MCU.

This mbed program programs target MCU flash memory through UART. It uses "In-System Programming (ISP)" interface in target MCU (NXP LPC micro-controllers).

The ISP is done by PC with serial cable normally. The ISP protocol is executed software on a PC. The software reads a data file and transfers the data with the ISP protocol.
This program does same process of that. The mbed performs a function like "FlashMagic" or "lpc21isp".
(This program does not just copy the binary but also insert 4 byte checksum at address 0x1C.)

This program currently supports LPC1114, LPC1115, LPC81x, LPC82x, LPC1768/LPC1769 and LPC11U68/LPC11E68.

Information

For the LPC1768 and LPC1769, this program supports writing only. It cannot perform verifying.

Modification for targeting LPC82x series has been done by Mr. k4zuki. Thank you very much!
Modification for targeting LPC11U68/LPC11E68 has been done by HAPI- Tech. Thank you very much!!

/media/uploads/okano/copying_bin_e.png

How to execute

With this program, all you need to do is..

Connect the mbed and the target (/RESET and /ISP_enable signals in are option. Those are not necessary if you set the target ISP mode manually)
Rename your (binary) file to "bin" and copy into the mbed storage.
Press reset button of mbed.

When the program completed successfully, you will find the LEDs on mbed blinks sequentially (LED1→LED2→LED3→LED4).
If it failed, the mbed reports it "Runtime error" by LEDs.
You can also monitor the progress and result on a terminal screen (mbed reports those by printf).
if you enabled "AUTO_PROGRAM_START", the program in the target will be started automatically.
from version 0.7, this program works as "USB-serial bridge" after the ISP writing done. The serial enabled target program (and if "AUTO_PROGRAM_START" is enabled, ) the UART will come up on the terminal screen after ISP completion. Please set "TARGET_OPERATION_BAUD_RATE" as baud rate of target program. The ISP speed can be set by "ISP_BAUD_RATE" separately.

/media/uploads/okano/files_in_storage_e.png

Information

If you don't have a file named "bin", the program will ask you which file you want to choose.
You will find a list of files on PC terminal and that interface let you select a file as source.
(The file names will appear in 8.3 format like old DOS.)

There are some options to bypassing the ISP to execute USB-serial through mode or erasing flash.

If there is a "bin" file, the program may work as usual.
(updated on 29-Jan-2015)

Sample of operation

Next picture is sample of the operation.

The target (LPC1114) goes into ISP mode after first reset.
mbed writes binary into flash in the target (binary size is 12668 bytes in this sample).
when the writing completed, mbed starts reading the flash. the data is verified by comparing with original file.
Asserting reset again with "ISP_enable pin" HIGH.
The target starts to work with written binary (program). In this sample, the target sending character data on UART and toggling LED (GPIO) pin periodically.

/media/uploads/okano/isp_operation_sample_1114_e2.png

Recipe for adding chip support

Information

This section had been written by At_Zamasu_Zansu.
Thank you！

Describing how to add a target device.
Register new Device ID in target_table.cpp.

Targets defined in target_table.cpp.

target_table.cpp

target_param    target_table[]  = {
    { "unknown ttarget",        0xFFFFFFFF, 1024,    4096, 4096, UUENCODE, 0x10000200 },
    { "LPC1114FN28(FDH28)/102", 0x0A40902B, 4096,   32768, 4096, UUENCODE, 0x10000200 },
    { "LPC1114FN28(FDH28)/102", 0x1A40902B, 4096,   32768, 4096, UUENCODE, 0x10000200 },
    { "LPC810M021FN8",          0x00008100, 1024,    4096, 1024, BINARY,   0x10000300 },
    { "LPC811M001JDH16",        0x00008110, 2048,    8192, 1024, BINARY,   0x10000300 },
    { "LPC812M101JDH16",        0x00008120, 4096,   16384, 1024, BINARY,   0x10000300 },
    { "LPC812M101JD20",         0x00008121, 4096,   16384, 1024, BINARY,   0x10000300 },
    { "LPC812M101JDH20",        0x00008122, 4096,   16384, 1024, BINARY,   0x10000300 },
///added for LPC82x series
    { "LPC824M201JHI33",        0x00008241, 8192,   32768, 1024, BINARY,   0x10000300 },
    { "LPC822M101JHI33",        0x00008221, 4096,   16384, 1024, BINARY,   0x10000300 },
    { "LPC824M201JDH20",        0x00008242, 8192,   32768, 1024, BINARY,   0x10000300 },
    { "LPC822M101JDH20",        0x00008222, 4096,   16384, 1024, BINARY,   0x10000300 },
 
};

Structure of the table is defined in target_table.h.

target_table.h

typedef struct  taget_param_st {
    char            *type_name;
    int             id;
    int             ram_size;
    int             flash_size;
    int             sector_size;
    int             write_type;
    unsigned int    ram_start_address;
}

Items are defined in order of next sample in target_table.cpp

 {type_name, id, ram_size, flash_size, sector_size, write_type, ram_start_address}

Sample of how to do this

Data can be found in usermanual(UM) and datasheet. An example following.

In case of LPC82xx
UM10800 LPC82x User manual http://www.nxp.com/documents/user_manual/UM10800.pdf
LPC82x Product data sheet http://www.nxp.com/documents/data_sheet/LPC82X.pdf

type_name：
- Table 322. Part identification numbers can be found by searching in UM. Pick up a device from the Table 322.

id:
- Put a Hex coding value in Table 322.

ram_size:
- Put target RAM size which can be found in datasheet by searching "Ordering options". Find the RAM size in Table2 (in bytes)

flash_size:
- Put target flash size from the Table 2.
  The size should be calculated as "1KB = 1024" bytes.

sector_size:
- A description of "The size of a sector is 1 KB and the size of a page is 64 Byte. One sector contains 16 pages" can be found in 25.5 General description, UM. Pick up taeget sector size and put it into the table in bytes. In this case, it will be 1024.
- In case of LPC176x, the secotr size is 4KB for first 16 sectors and rest are 32K. So it cannot be defined by single value. For this type of targets, prepare a special value for the sector size. The program calculates the size when this value is detected.

write_type：
- Set "BINARY" if the target is not defined as UUENCODE type on application note: http://www.nxp.com/documents/application_note/AN11229.pdf. Write type can be found in UM by searching "Write to RAM" or "Write to RAM <start address> <number of bytes>". For insance, http://www.nxp.com/documents/user_manual/UM10360.pdf says the LPC17xx uses UUENCODE.

ram_start_address：
- Put an address of example which can be found by searching "UART ISP Write to RAM command" or "Write to RAM" in UM

Reference

DIP28 package ARM : LPC1114 code development by mbed → Getting started with mbed LPC1114
Idea of this program is based on Chris' notebook page: "Prototype to hardware". This page introduces the ISP flash programming using an mbed as USB-UART interface.
"Chapter 26: LPC111x/LPC11Cxx Flash programming firmware" in LPC111x/LPC11Cxx User manual UM10398
"Chapter 22: LPC800 Flash ISP and IAP programming" in LPC800 User manual UM10601
Writing flash in LPC812 SO20 package chip (LPC812M101JDH20FP) (Japanese) → http://qiita.com/matsujirushi/items/691ee3514667ca602576

イカ醤油ポッポ焼き

mbed用ISPプログラム

NXP製のマイコンは，内部フラッシュメモリへのプログラムの書き込みをUART経由で行うことができます．
通常，この作業はPC上のソフトウェア(たとえば"FlashMagic"や"lpc21isp"など)を用いて，PC上のファイルのデータを，UARTで接続したマイコンの内蔵フラッシュに書き込みます．

「イカ醤油ポッポ焼き」はmbedでそれらのソフトの代わりをさせるものです．mbedストレージ内に置いた「bin」と名付けられたファイルを読み，フラッシュへ書き込みます．
この書き込みを行う際には，アドレス0x1Cに置いておく必要のある4バイトのチェックサムも自動で追加されます．

現在サポートしているターゲットはLPC1114，LPC1115，LPC81x，LPC82x，LPC1768/LPC1769， LPC11U68/LPC11E68です．

Information

LPC1768 and LPC1769 では書き込みのみがサポートされます．読み出し検証は実行されません．

LPC82xシリーズをターゲットとするための変更をk4zukiさんがしてくださいました．ありがとうございます！
LPC11U68/LPC11E68をターゲットとするための変更をHAPI- Techさんがしてくださいました．ありがとうございます！

/media/uploads/okano/copying_bin_j.png

美味しい料理法

このプログラムの動かし方は次の通り

mbedとターゲット(書き込み対象のマイコン)を接続する (ターゲットを手動でISPモードに入れる場合には，/RESET と /ISP_enable は接続する必要はありません)
書き込みたいファイル(バイナリフォーマット)の名前を「bin」に変更して，mbed内にコピー
mbedのリセットボタンを押す

書き込みが無事に終了するとmbed上のLEDが順番に点滅を繰り返します(LED1→LED2→LED3→LED4).
もし何らかのエラーが発生して失敗した場合には"Runtime error"が発生した時のLED点灯となります．
またコンピュータのターミナルで状況や結果を確認することもできます(mbedがprintfで状況を出力しています)
"AUTO_PROGRAM_START"を有効にしてあれば，書き込み終了後，ターゲットのプログラムは自動的にスタートします.
バージョン0.7以降，このプログラムはISP書き込みの終了後にUSB-Serialブリッジとして動作するようにしてあります．ターゲットのプログラムがシリアルを使うもので(かつ"AUTO_PROGRAM_START"が有効で)あれば，入出力はそのままISP完了後のターミナルに現れます．"TARGET_OPERATION_BAUD_RATE"はターゲットのプログラムが使うボーレートに合わせてください．ISPの書き込みに使うボーレートは "これとは別に"ISP_BAUD_RATE"で指定することができます.

/media/uploads/okano/files_in_storage_j2.png

Information

もし「bin」と名付けられたファイルが見つからなければ，(PCターミナル上で)どのファイルを選択するかが訊ねられます．
その表示を確認して，どのファイルを書き込むのかを選択してください．
「bin」ファイルが有れば，これまでと同じように動作します．(ファイル名はDOSのような8.3フォーマットで表示されます)

この他，ISPをバイパスしてシリアススルー・モードに行ったり，フラッシュを消すだけという操作も可能になっています．

(2015年1月29日にアップデートされました)

動作の例

次の図は動作の例です

最初のリセットによってターゲット(LPC1114)がISPモードに入ります
mbedがターゲットのフラッシュにバイナリを書き込みます(この例では12668バイトのバイナリを書いています)
書き込みが終わるとフラッシュの読み出しを始めます．このデータを元のファイルとの比較し，検証を行います
ISPイネーブル・ピンをHIGHにして再度リセットを行います
ターゲットは書き込まれたプログラムの実行を開始します．この例ではターゲットは周期的にUARTへ文字データを送り，LEDを(GPIOピン)を点滅させます
The target starts to work with written binary (program). The target sending character data on UART and toggling LED (GPIO) pin periodically.

/media/uploads/okano/isp_operation_sample_1114_j2.png

イカ醤油ポッポ焼き味付けレシピ

Information

この節はざますざんすさんが作成してくれました．
ありがとうございます！

これは，イカ醤油ポッポ焼きに新しいターゲットデバイスを追加する場合のレシピを纏めたものです．

必要事項：target_table.cpp へ新しいDevice ID register を追加する．

target_table.cppに記載されているターゲット一覧．

target_table.cpp

target_param    target_table[]  = {
    { "unknown ttarget",        0xFFFFFFFF, 1024,    4096, 4096, UUENCODE, 0x10000200 },
    { "LPC1114FN28(FDH28)/102", 0x0A40902B, 4096,   32768, 4096, UUENCODE, 0x10000200 },
    { "LPC1114FN28(FDH28)/102", 0x1A40902B, 4096,   32768, 4096, UUENCODE, 0x10000200 },
    { "LPC810M021FN8",          0x00008100, 1024,    4096, 1024, BINARY,   0x10000300 },
    { "LPC811M001JDH16",        0x00008110, 2048,    8192, 1024, BINARY,   0x10000300 },
    { "LPC812M101JDH16",        0x00008120, 4096,   16384, 1024, BINARY,   0x10000300 },
    { "LPC812M101JD20",         0x00008121, 4096,   16384, 1024, BINARY,   0x10000300 },
    { "LPC812M101JDH20",        0x00008122, 4096,   16384, 1024, BINARY,   0x10000300 },
///added for LPC82x series
    { "LPC824M201JHI33",        0x00008241, 8192,   32768, 1024, BINARY,   0x10000300 },
    { "LPC822M101JHI33",        0x00008221, 4096,   16384, 1024, BINARY,   0x10000300 },
    { "LPC824M201JDH20",        0x00008242, 8192,   32768, 1024, BINARY,   0x10000300 },
    { "LPC822M101JDH20",        0x00008222, 4096,   16384, 1024, BINARY,   0x10000300 },
 
};

上記コードは以下の構造を取っている．target_table.h に以下のコードがある．

target_table.h

typedef struct  taget_param_st {
    char            *type_name;
    int             id;
    int             ram_size;
    int             flash_size;
    int             sector_size;
    int             write_type;
    unsigned int    ram_start_address;
}

以下の順番にtarget_table.cppにコーディングする．

 {type_name, id, ram_size, flash_size, sector_size, write_type, ram_start_address}

作業の手順例

データはユーザマニュアル(UM)と Data sheet から検索する．以下に例を上げる．

LPC82xxの場合
UM10800 LPC82x User manual http://www.nxp.com/documents/user_manual/UM10800.pdf
LPC82x Product data sheet http://www.nxp.com/documents/data_sheet/LPC82X.pdf

type_name：
- UMから Part identification numbers を検索すると，Table 322. Part identification numbersが現れる．Table 322より Table記載のDeviceを入力．

id:
- UMから Part identification numbers を検索，Table 322. よりHex codingを入力．

ram_size:
- Product data sheet よりOrdering options を検索しTable2より上記Deviceと同じターゲットのRAMサイズを記載(byte)

flash_size:
- Product data sheet よりOrdering options を検索しTable2より上記Deviceと同じターゲットのFlashサイズを記載(byte)
  尚，1KBは1024byteにて計算

sector_size:
- UMから Flash configuration を検索し25.5 General description に「The size of a sector is 1 KB and the size of a page is 64 Byte. One sector contains 16 pages.」と記載があるので，ターゲットのSectorサイズを記載（byte単位）．今回の場合は1KBなので1024byte．
- LPC176xシリーズのセクタサイズは，最初の16セクタが4KB，残りを32KBとしているため一定の値では表せません．これに対応するため特別な値を用意して，プログラム内でその値を検出した際には実際の構成に則した計算を行うようにしています．

write_type：
- 通常はBINARYを指定．ただし，http://www.nxp.com/documents/application_note/AN11229.pdf に記載のあるチップはUUENCODEで．UMをWrite to RAM や Write to RAM <start address> <number of bytes> で検索すると書き込みタイプが出てきます．例えばLPC17xx等はhttp://www.nxp.com/documents/user_manual/UM10360.pdf で確認するとUUENCODEとなる．

ram_start_address：
- UMからUART ISP Write to RAM command もしくは Write to RAM を検索．Example に書いてあるアドレスを記載する．

参考

DIP28パッケージのARM：LPC1114のコードをmbedで → [lang:ja] mbed LPC1114での遊び方
このプログラムのアイデアはクリスさんのノートブック・ページ: "Prototype to hardware"に端を発しています．このページにはmbedをUSB-UART変換器として使ったISPでのデータ書き込みが紹介されています
LPC111x/LPC11Cxx ユーザマニュアル UM10398，"第26章: LPC111x/LPC11Cxx Flash programming firmware"
LPC800 ユーザマニュアル UM10601，"第22章: LPC800 Flash ISP and IAP programming"
「イカ醤油ポッポ焼き -> LPC812」 (SO20パッケージのLPC812に書き込みを行う際の注意点) → http://qiita.com/matsujirushi/items/691ee3514667ca602576

日本語版だけの(何の役にも立たない)参考情報

Information

何故このプログラムが作られたか．そして何故こんな名前なのか．
こちらを御覧ください →→ イカ醤油ポッポ焼きはイカにして生まれたか（´(ｪ)｀;

このプログラムを作ってみるきっかけになったツイート．

8月のある日の昼ごはんを食べたあとにボーっとしてた時の思いつき．
https://twitter.com/tedd_okano/status/370758009749647361
このファイル名拡張子「.bin」の問題は結局放置
https://twitter.com/tedd_okano/status/370758364109631489
そしてこういうことに
https://twitter.com/tedd_okano/status/370764502142169088
結論(笑
https://twitter.com/tedd_okano/status/370765594628337664

（´(ｪ)｀）

Download repository: zip gz

Files at revision 52:4b1a0488e0e3

/dir_handling/ default tip

Name	Size	Actions
[up]
dir_handling.cpp	6406	Revisions Annotate
dir_handling.h	159	Revisions Annotate

Repository toolbox

Export to desktop IDE

Build repository

Repository details

Type:	Program
Mbed OS support:	Mbed 2 deprecated
Created:	24 Aug 2013
Imports:	700
Forks:	3
Commits:	53
Dependents:	0
Dependencies:	3
Followers:	32
Issues:	0

The code in this repository is Apache licensed.

Information

日本語版がこのページ下半分にあります！

Caution!

ISP programming application on mbed

ISP program writes data into flash memory of target MCU.

Information

How to execute

Information

Sample of operation

Recipe for adding chip support

Information

target_table.cpp

target_table.h

Sample of how to do this

Reference

イカ醤油ポッポ焼き

mbed用ISPプログラム

Information

美味しい料理法

Information

動作の例

イカ醤油ポッポ焼き味付けレシピ

Information

target_table.cpp

target_table.h

作業の手順例

参考

日本語版だけの(何の役にも立たない)参考情報

Information

Files at revision 52:4b1a0488e0e3

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning