ISO 17215-3:2021
(Main)Road vehicles — Video communication interface for cameras (VCIC) — Part 3: Camera message dictionary
Road vehicles — Video communication interface for cameras (VCIC) — Part 3: Camera message dictionary
This document specifies the standardized camera messages and data types used by a VCIC camera (OSI layer 7). Applications hosted on ECUs want to communicate with one or more cameras (e.g. “Ask camera for parameters.”). If the applications can use standardized services supported by the cameras (API layer 7), the development of a vision application is independent on the camera used. The services can be implemented by general libraries. The definition of streaming data is not an issue of this API.
Véhicules routiers — Interface de communication vidéo pour caméras (ICVC) — Partie 3: Dictionnaire de message de caméra
General Information
Relations
Standards Content (Sample)
INTERNATIONAL ISO
STANDARD 17215-3
Second edition
2021-05
Road vehicles — Video communication
interface for cameras (VCIC) —
Part 3:
Camera message dictionary
Véhicules routiers — Interface de communication vidéo pour caméras
(ICVC) —
Partie 3: Dictionnaire de message de caméra
Reference number
©
ISO 2021
© ISO 2021
All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may
be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting
on the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address
below or ISO’s member body in the country of the requester.
ISO copyright office
CP 401 • Ch. de Blandonnet 8
CH-1214 Vernier, Geneva
Phone: +41 22 749 01 11
Email: copyright@iso.org
Website: www.iso.org
Published in Switzerland
ii © ISO 2021 – All rights reserved
Contents Page
Foreword .v
Introduction .vi
1 Scope . 1
2 Normative references . 1
3 Terms and definitions . 1
4 Symbols and abbreviated terms . 2
5 Conventions . 2
6 Overview of ISO 17215 series . 3
6.1 General . 3
6.2 Document overview and structure . 3
6.3 Open Systems Interconnection (OSI) model . 4
6.4 Document reference according to OSI model . 4
7 Camera application interface (OSI layer 7) . 6
7.1 Specific properties . 6
7.2 API principles . 6
7.2.1 Image cropping and windowing . 7
7.3 API data types . 7
7.4 API Return codes . 8
7.5 API enumerations . 8
7.5.1 Enumeration eMethodID . 8
7.5.2 Enumeration eEventGroupType . 9
7.5.3 Enumeration eCamErrorCodes .10
7.5.4 Enumeration eCameraMode .10
7.5.5 Enumeration eControlIndex .11
7.5.6 Enumeration eControlSupportedModes .11
7.5.7 Enumeration eControlMode .11
7.5.8 Enumeration ePersistentStorageID .12
7.6 API structures .12
7.6.1 Structure sPixelPosition .12
7.6.2 Structure sPixelMap .13
7.6.3 Structure sRectangle . . .13
7.6.4 Structure sImageDimension .14
7.6.5 Structure sImagerRegister .14
7.6.6 Structure sImagerRegisterBlock .14
7.6.7 Structure sImagerCharacteristic .14
7.6.8 Structure sIntrinsicCamParam .15
7.6.9 Structure sExtrinsicCamParam .16
7.6.10 Structure sPersistentEntryList .17
7.6.11 Structure sPersistentStorageEntry .17
7.6.12 Structure sTimeStamp .18
7.6.13 Structure sDatasheet .18
7.6.14 Structure sRegionOfInterest .18
7.6.15 Structure sVideoFormat .20
7.6.16 Structure sHistogramFormat .21
7.6.17 Structure sHistogramContent .22
7.6.18 Structure sVideoContent .22
7.6.19 Structure sControlMode .23
7.6.20 Structure sUnsignedCtl .23
7.6.21 Structure sSignedCtl .23
7.6.22 Structure sCombinedCtl .24
7.6.23 Structure sCamControl .24
7.6.24 Structure sCamStatus .24
7.6.25 Temperature .25
7.7 API reference .28
7.7.1 getDataSheet (MethodID 0x0001) .28
7.7.2 getCamStatus (MethodID 0002 ) .28
7.7.3 setCamMode (MethodID 0003 ).28
7.7.4 setCamExclusive (MethodID 0011 ) .29
7.7.5 eraseCamExclusive (MethodID 0019 ) .29
7.7.6 setHostParameters (MethodID 0022 ) .30
7.7.7 getHostParameters (MethodID 0024 ).30
7.7.8 eraseHostParameters (MethodID 0029 ) .31
7.7.9 setRegionOfInterest (MethodID 0101 ) .31
7.7.10 setRegionsOfInterest (MethodID 0102 ) .32
7.7.11 getRegionOfInterest (MethodID 0103 ) .32
7.7.12 getRegionsOfInterest (MethodID 0104 ) .32
7.7.13 eraseRegionOfInterest (MethodID 0109 ).33
7.7.14 setVideoFormat (MethodID 0111 ) .33
7.7.15 getVideoFormat (MethodID 0113 ) .34
7.7.16 eraseVideoFormat (MethodID 0119 ) .34
7.7.17 setHistogramFormat (MethodID 0121 ) .35
7.7.18 getHistogramFormat (MethodID 0123 ) .35
7.7.19 eraseHistogramFormat (MethodID 0129 ) .36
7.7.20 SubscribeROIVideo (MethodID 0131 ) .36
7.7.21 UnSubscribeROIVideo (MethodID 0132 ) .37
7.7.22 SubscribeROIHistogram (MethodID 0x0133) .37
7.7.23 UnSubscribeROIHistogram (MethodID 0x0134) .37
7.7.24 setCamControl (MethodID 0201 ) .38
7.7.25 setCamControls (MethodID 0202 ) .38
7.7.26 getCamControl (MethodID 0203 ) .38
7.7.27 getCamControls (MethodID 0204 ) .39
7.7.28 setCamRegister (MethodID 0301 )
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.