JSON Specifications

M00141200

JSON Specifications Sheet

JSON Specifications
This explains the JSON format specifications used in the following API for Epson ePOS SDK for Android.
• setPrinterSettingEx
• setGetPrinterSettingExListener
RW: Read Write (settings can be acquired and changed)
RO: Read Only (settings can only be acquired)

Key Info Value Info

Attri- Remarks
1 2 3 Description List and explanation of set values
bute
FormatName Format name RW TM genre printer information format "TM-Form"

Rev Information format management number (data structure changes managed as Rev) RW TM genre printer information format revision number "1"

PrinterSpec Printer specifications information

Product Product information

SerialNo Serial number RO Serial number (values that can be acquired with the GS I 68 command)

Spec Specifications information

Currently selected multilingual font name

Language Multilingual font name RO
(Values that can be acquired with the GS I 69 command)

Setting Setting

AutoCut Cutter-related

CutAfterPaperset Paper automatic cut at cover close (GS (E fn = 5, a = 100) RW "Invalid": Does not cut, "Valid": Cuts

Buzzer Buzzer function

Select Buzzer functionSelection of valid buzzer (GS (E fn = 5, a = 119) RW "Invalid": Invalid, "Valid": Valid

Command Command-related functions

Automatic line feeding (MSW1-5 or DSW1-1)

Cannot be changed if parallel interface is installed. "Invalid": Normally disabled (MSW1-5 OFF)
AutoCR RW
[Related items] "Valid": Normally enabled (MSW1-5 ON)
PrinterSpec/Interface/UIB

Print Print-related settings

"DIPSW": In accordance with DIP switch settings

"70%": 70%

"75%": 75%
Density Print density (GS (E fn = 5, a = 5) RW
"80%": 80%

"85%": 85%

"90%": 90%

1
 JSON Specifications

Key Info Value Info

Attri- Remarks
1 2 3 Description List and explanation of set values
bute
"95%": 95%

"100%": 100%

"105%": 105%

"110%": 110%
Density Print density (GS (E fn = 5, a = 5) RW
"115%": 115%

"120%": 120%

"125%": 125%

"130%": 130%

"Level1": Print speed level 1

"Level2": Print speed level 2

"Level3": Print speed level 3

"Level4": Print speed level 4

"Level5": Print speed level 5

"Level6": Print speed level 6

"Level7": Print speed level 7

"Level8": Print speed level 8

Speed Print speed (GS (E fn = 5, a = 6) RW "Level9": Print speed level 9

"Level10": Print speed level 10

"Level11": Print speed level 11

"Level12": Print speed level 12

"Level13": Print speed level 13

"Level14": Print speed level 14

"Level15": Print speed level 15

"Level16": Print speed level 16

"Level17": Print speed level 17

"Standard": Standard column mode

"48/36": 48/36 column mode

"48¥¥/36": 48/36 column mode (with ¥ symbol) "X/Y" refer to the following:
"46/32": 46/32 column mode X: Number of columns when
ColumnEmulation Number of columns emulation (GS (E fn = 5, a = 11) RW paper width is 80 mm
"46¥¥/32": 46/32 column mode (with ¥ symbol, supports escape character)
Y: Number of columns when
"42/42": 42 column mode paper width is 50 mm
"42/32": 42/32 column mode
"42¥¥/32": 42/32 column mode (with ¥ symbol, supports escape character)

2
 JSON Specifications

Key Info Value Info

Attri- Remarks
1 2 3 Description List and explanation of set values
bute
"58mm": 58 mm
RollPaperWidth Paper width (GS (E fn = 5, a = 3) RW
"80mm": 80 mm

NearEndSetting NearEnd sensor enabled/disabled (MemSW5-6) RW "Disable": Disabled, "Enable": Enabled

Maintenance

ThermalHead

"-1": Failed to detect missing dots

NumberOfWarningDot Returns the number of dots exceeding the Warning threshold value (dots that may soon be cut off ) RO "0": No dots exceeding the Warning threshold value
"1" to "512": Number of dots exceeding the Warning threshold value

Position of the dots exceeding the Warning threshold value "" (blank character): Failed to detect missing dots. Alternatively, there are no dots exceeding the Warn-
PositionOfWarningDot The position of the left-end dots on the print surface is treated as 1, and this returns all the positions of RO ing threshold value.
the dots exceeding the Warning threshold value. "Hexadecimal string": Dots exceeding the Warning threshold value.

"-1": Failed to detect missing dots

NumberOfBrokenDot Returns the number of dots exceeding the Fault threshold value (broken dots). RO "0": No dots exceeding the Fault threshold value
"1" to "512": Number of dots exceeding the Fault threshold value

Position of the dots exceeding the Fault threshold value "" (blank character): Failed to detect missing dots. Alternatively, there are no dots exceeding the Fault
PositionOfBrokenDot The position of the left-end dots on the print surface is treated as 1, and this returns all the positions of RO threshold value.
the dots exceeding the Fault threshold value. "Hexadecimal string": Dots exceeding the Fault threshold value.

Counter Maintenance counter (total)

RollPaper_FeedLines Number of paper feed lines [lines] RO "" to "": 4-byte decimal maximum value

RollPaper_CutterDrives Auto cutter drive count [times] RO "" to "": 4-byte decimal maximum value

3
 jsonString Acquisition Example

jsonString Acquisition Example Corresponding Models

TM-m30II-H
{ Key Info

TM-m30II
"PrinterSpec": {

EU-m30
"Product": { Value
"SerialNo": "ABCD000002" 1 2 3
},
"Spec": {
FormatName "TM-Form" ✔ ✔ ✔
"Language": "KANJI JAPANESE"
} Rev "1" ✔ ✔ ✔
},
"Setting": { PrinterSpec ✔ ✔ ✔
"AutoCut": {
"CutAfterPaperset": "Invalid" Product ✔ ✔ ✔
},
"Buzzer": { SerialNo ✔ ✔ ✔
"Select": "Valid"
}, Spec ✔ ✔ ✔
"Command": {
"AutoCR": "Invalid" Language ✔ ✔ ✔
},
"Print": { Setting ✔ ✔ ✔
"Density": "100%",
"Speed": "Level13", AutoCut ✔ ✔ ✔
"ColumnEmulation": "Standard",
"RollPaperWidth": "80mm", CutAfterPaperset "Invalid"?"Valid" ✔ ✔ ✔
"NearEndSetting": "Disable"
Buzzer ✔ ✔ ✔
}
}, Select "Invalid"?"Valid" ✔ ✔ ✔
"Maintenance": {
"ThermalHead": { Command ✔ ✔ ✔
"NumberOfWarningDot": "0",
"PositionOfWarningDot": "", AutoCR "Invalid"?"Valid" ✔ ✔ ✔
"NumberOfBrokenDot": "0",
"PositionOfBrokenDot": "" Print ✔ ✔ ✔
},
"Counter": { "DIPSW" - - -
"RollPaper_FeedLines": "53408",
"RollPaper_CutterDrives": "5647" "70%" ✔ ✔ ✔
}
}, "75%" ✔ ✔ ✔
"FormatName": "TM-Form",
"Rev": "1" "80%" ✔ ✔ ✔
}
"85%" ✔ ✔ ✔

"90%" ✔ ✔ ✔

"95%" ✔ ✔ ✔
Density
"100%" ✔ ✔ ✔

"105%" ✔ ✔ ✔

"110%" ✔ ✔ ✔

"115%" ✔ ✔ ✔

"120%" ✔ ✔ ✔

"125%" ✔ ✔ -

"130%" ✔ ✔ -

4
 Corresponding Models

TM-m30II-H

TM-m30II-H
Key Info Key Info

TM-m30II

TM-m30II
EU-m30

EU-m30
Value Value
1 2 3 1 2 3

"Level1" ✔ ✔ ✔ Counter ✔ ✔ ✔

"Level2" ✔ ✔ ✔ RollPaper_FeedLines ✔ ✔ ✔

"Level3" ✔ ✔ ✔ RollPaper_CutterDrives ✔ ✔ ✔

"Level4" ✔ ✔ ✔

"Level5" ✔ ✔ ✔

"Level6" ✔ ✔ ✔

"Level7" ✔ ✔ ✔

"Level8" ✔ ✔ ✔

Speed "Level9" ✔ ✔ ✔

"Level10" ✔ ✔ ✔

"Level11" ✔ ✔ ✔

"Level12" ✔ ✔ ✔

"Level13" ✔ ✔ ✔

"Level14" ✔ - -

"Level15" - - -

"Level16" - - -

"Level17" - - -

"Standard" ✔ ✔ ✔

"48/36"?"48¥¥/36" - - -

ColumnEmulation "46/32"?"46¥¥/32" - - -

"42/42" - - -

"42/32"?"42¥¥/32" ✔ ✔ ✔

"58mm" ✔ ✔ ✔
RollPaperWidth
"80mm" ✔ ✔ ✔

NearEndSetting "Disable"?"Enable" ✔ ✔ ✔

Maintenance ✔ ✔ ✔

ThermalHead - ✔ ✔

NumberOfWarningDot - - ✔

PositionOfWarningDot - - ✔

NumberOfBrokenDot - - ✔

PositionOfBrokenDot - - ✔

5
 JSON 仕様

JSON 仕様シート
JSON仕様
Epson ePOS SDK for Android の下記 API で使用する JSON フォーマットの仕様を解説します。
• setPrinterSettingEx
• setGetPrinterSettingExListener
RW: Read Write( 設定の取得及び変更可能 )
RO: Read Only( 設定の取得のみ可能 )

Key Info Value Info

備考
1 2 3 説明 属性 設定値の一覧、説明
FormatName フォーマット名 RW TM ジャンルのプリンター情報フォーマット "TM-Form"

Rev 情報フォーマットの管理番号（データ構造変更を Rev で管理する） RW TM ジャンルのプリンター情報フォーマットのリビジョン番号 "1"

PrinterSpec プリンター仕様情報

Product 製品情報

SerialNo シリアル番号 RO シリアル番号（GS I 68 コマンドで取得できる値）

Spec 仕様情報

現在選択されている多国語フォント名
Language 多国語フォント名 RO
（GS I 69 コマンドで取得できる値）

Setting 設定

AutoCut カッター関連

CutAfterPaperset カバークローズ時の用紙自動カット (GS (E fn=5 a=100) RW "Invalid": カットしない、"Valid": カットする

Buzzer Buzzer 機能

Select ブザー機能 有効なブザーの選択 (GS (E fn=5 a=119) RW "Invalid": 無効、"Valid": 有効

Command コマンド関連機能

自動改行 (MSW1-5 or DSW1-1)

Parallel インターフェイスを搭載している場合、変更不可。 "Invalid": 常時無効 (MSW1-5 OFF)
AutoCR RW
【関連項目】 "Valid": 常時有効 (MSW1-5 ON)
PrinterSpec/Interface/UIB

Print 印刷関連設定

"DIPSW": ディップスイッチの設定に従う

"70%": 70%

"75%": 75%

Density 印字濃度 (GS (E fn=5 a=5) RW "80%": 80%

"85%": 85%

"90%": 90%

"95%": 95%

6
 JSON 仕様

Key Info Value Info

備考
1 2 3 説明 属性 設定値の一覧、説明
"100%": 100%

"105%": 105%

"110%": 110%

Density 印字濃度 (GS (E fn=5 a=5) RW "115%": 115%

"120%": 120%

"125%": 125%

"130%": 130%

"Level1": 印字速度レベル 1

"Level2": 印字速度レベル 2

"Level3": 印字速度レベル 3

"Level4": 印字速度レベル 4

"Level5": 印字速度レベル 5

"Level6": 印字速度レベル 6

"Level7": 印字速度レベル 7

"Level8": 印字速度レベル 8

Speed 印字速度 (GS (E fn=5 a=6) RW "Level9": 印字速度レベル 9

"Level10": 印字速度レベル 10

"Level11": 印字速度レベル 11

"Level12": 印字速度レベル 12

"Level13": 印字速度レベル 13

"Level14": 印字速度レベル 14

"Level15": 印字速度レベル 15

"Level16": 印字速度レベル 16

"Level17": 印字速度レベル 17

"Standard": 標準桁モード

"48/36": 48/36 桁モード

"48¥¥/36": 48/36 桁モード（¥ 記号あり）

"46/32": 46/32 桁モード "X/Y" は

ColumnEmulation 桁数エミュレーション (GS (E fn=5 a=11) RW X: 紙幅 80 mm 時の桁数
"46¥¥/32": 46/32 桁モード（¥ 記号あり、エスケープ文字対応）
Y: 紙幅 50 mm 時の桁数
"42/42": 42 桁モード を表す。
"42/32": 42/32 桁モード
"42¥¥/32": 42/32 桁モード（¥ 記号あり、エスケープ文字対応）

"58mm": 58 mm
RollPaperWidth 用紙幅 (GS (E fn=5 a=3) RW
"80mm": 80 mm

7
 JSON 仕様

Key Info Value Info

備考
1 2 3 説明 属性 設定値の一覧、説明
NearEndSetting NearEnd センサーの有効無効 (MemSW5-6) RW "Disable": 無効、"Enable": 有効

Maintenance

ThermalHead

"-1": ドット抜けの検出に失敗した
NumberOfWarningDot Warning 閾値を超えたドット（もうすぐ壊れそうなドット）の数を返す。 RO "0": Warning 閾値を超えたドットなし
"1" ∼ "512": Warning 閾値を超えたドットの数

Warning 閾値を超えたドットの位置 ""（空文字）: ドット抜けの検出に失敗した。もしくは、Warning 閾値を超えたドットがない。

PositionOfWarningDot RO
印刷面左端ドットの位置を 1 とし、Warning 閾値を超えた全てのドット位置を返す。 "16 進文字列 ": Warning 閾値を超えたドットがある。

"-1": ドット抜けの検出に失敗した
NumberOfBrokenDot 故障閾値を超えたドット（故障したドット）の数を返す。 RO "0": 故障閾値を超えたドットなし
"1" ∼ "512": 故障閾値を超えたドットの数

故障閾値を超えたドットの位置 ""（空文字）: ドット抜けの検出に失敗した。もしくは、故障閾値を超えたドットがない。

PositionOfBrokenDot RO
印刷面左端ドットの位置を 1 とし、故障閾値を超えた全てのドット位置を返す。 "16 進文字列 ": 故障閾値を超えたドットがある。

Counter メンテナンスカウンター（積算）

RollPaper_FeedLines 紙送り行数［行］ RO "" ∼ "": 4byte 10 進数最大値

RollPaper_CutterDrives オートカッター駆動回数［回］ RO "" ∼ "": 4byte 10 進数最大値

8
 jsonString の取得例

jsonStringの取得例 対応機種

TM-m30II-H
{ Key Info

TM-m30II
"PrinterSpec": {
"Product": { Value
"SerialNo": "ABCD000002" 1 2 3
},
"Spec": {
"Language": "KANJI JAPANESE"
} FormatName "TM-Form" ✔ ✔
},
Rev "1" ✔ ✔
"Setting": {
"AutoCut": { PrinterSpec ✔ ✔
"CutAfterPaperset": "Invalid"
}, Product ✔ ✔
"Buzzer": {
"Select": "Valid" SerialNo ✔ ✔
},
"Command": { Spec ✔ ✔
"AutoCR": "Invalid"
}, Language ✔ ✔
"Print": {
"Density": "100%", Setting ✔ ✔
"Speed": "Level13",
"ColumnEmulation": "Standard", AutoCut ✔ ✔
"RollPaperWidth": "80mm",
"NearEndSetting": "Disable" CutAfterPaperset "Invalid"、"Valid" ✔ ✔
}
}, Buzzer ✔ ✔
"Maintenance": {
Select "Invalid"、"Valid" ✔ ✔
"ThermalHead": {
"NumberOfWarningDot": "0", Command ✔ ✔
"PositionOfWarningDot": "",
"NumberOfBrokenDot": "0", AutoCR "Invalid"、"Valid" ✔ ✔
"PositionOfBrokenDot": ""
}, Print ✔ ✔
"Counter": {
"RollPaper_FeedLines": "53408", "DIPSW" - -
"RollPaper_CutterDrives": "5647"
} "70%" ✔ ✔
},
"FormatName": "TM-Form", "75%" ✔ ✔
"Rev": "1"
} "80%" ✔ ✔

"85%" ✔ ✔

"90%" ✔ ✔

"95%" ✔ ✔
Density
"100%" ✔ ✔

"105%" ✔ ✔

"110%" ✔ ✔

"115%" ✔ ✔

"120%" ✔ ✔

"125%" ✔ -

"130%" ✔ -

9
 対応機種

TM-m30II-H

TM-m30II-H
Key Info Key Info

TM-m30II

TM-m30II
Value Value
1 2 3 1 2 3

"Level1" ✔ ✔ Counter ✔ ✔

"Level2" ✔ ✔ RollPaper_FeedLines ✔ ✔

"Level3" ✔ ✔ RollPaper_CutterDrives ✔ ✔

"Level4" ✔ ✔

"Level5" ✔ ✔

"Level6" ✔ ✔

"Level7" ✔ ✔

"Level8" ✔ ✔

Speed "Level9" ✔ ✔

"Level10" ✔ ✔

"Level11" ✔ ✔

"Level12" ✔ ✔

"Level13" ✔ ✔

"Level14" - -

"Level15" - -

"Level16" - -

"Level17" - -

"Standard" ✔ ✔

"48/36"、"48¥¥/36" - -

ColumnEmulation "46/32"、"46¥¥/32" - -

"42/42" - -

"42/32"、"42¥¥/32" ✔ ✔

"58mm" ✔ ✔
RollPaperWidth
"80mm" ✔ ✔

NearEndSetting "Disable"、"Enable" ✔ ✔

Maintenance ✔ ✔

ThermalHead ✔ ✔

NumberOfWarningDot - ✔

PositionOfWarningDot - ✔

NumberOfBrokenDot - ✔

PositionOfBrokenDot - ✔

10